Metadata-Version: 2.4
Name: wsnowflake-mcp
Version: 0.1.0
Summary: Model Context Protocol (MCP) server for WSnowflake Snowflake architecture and code generation
Author-email: "WILLIAM R." <william@ecapturedtech.com>
License: MIT
Keywords: mcp,wsnowflake,snowflake,ai-agent,fastmcp,architecture
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: mcp>=1.0.0
Requires-Dist: pydantic>=2.0.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"

# wsnowflake-mcp: Model Context Protocol Server for WSnowflake

`wsnowflake-mcp` is an official **Model Context Protocol (MCP)** server built on top of **FastMCP** that equips AI agents with tools to architect, validate, scaffold, and generate code for **WSnowflake** (Snowflake SQL ORM using Pydantic models).

## Key Technologies & Libraries

- **[MCP Protocol](https://modelcontextprotocol.io/)**: Open standard connecting AI models to external tools and context.
- **[FastMCP](https://github.com/jlowin/fastmcp)**: Python framework for fast MCP server implementation.
- **[WSnowflake](file:///home/william.rodriguez/Documents/w_libraries/w_libraries/wSnowflake)**: Snowflake SQL ORM engine with Pydantic validation.
- **[Pydantic v2](https://docs.pydantic.dev/)**: Data schema validation and Python AST inspection.
- **[Pytest](https://docs.pytest.org/)**: Modern Python testing framework.
- **[Pytest-Cov](https://pytest-cov.readthedocs.io/)**: Code coverage measurement for pytest.
- **[Docker](https://www.docker.com/)**: Containerized test execution environment.

---

## MCP Tools Exposed

1. **`validate_model_schema(model_code: str)`**: Validates Pydantic document models for WSnowflake compatibility.
2. **`search_wsnowflake_pattern(query: str)`**: Searches the official wisrovi SUITE catalog for WSnowflake architectural patterns.
3. **`deploy_wsnowflake_scaffolding(target_dir: str, project_name: str)`**: Deploys project scaffolding.
4. **`get_wsnowflake_architect_blueprints()`**: Returns code reference and blueprints for WSnowflake features.
5. **`get_wsnowflake_architect_manual()`**: Returns the comprehensive WSnowflake architecting manual.
6. **`generate_wsnowflake_crud(model_code: str)`**: Automatically generates repository CRUD class for Pydantic models.

---

## Running Unit Tests & Coverage

```bash
pip install -e .
PYTHONPATH=src pytest tests/
./scripts/run_coverage.sh
```

---

*Part of the wisrovi SUITE ecosystem.*
