vtkapi-mcp

# VTK API Validation via MCP Post-generation validation of VTK Python code using Model Context Protocol (MCP). ## Overview This module provides automatic validation of generated VTK code to catch API hallucinations: - ✅ **Direct API lookups** - No vector search overhead, exact class/method verification - ✅ **Method existence validation** - Detects when LLM invents non-existent methods - ✅ **Import validation** - Verifies VTK classes are imported from correct modules - ✅ **Fast in-memory index** - Loads ~2,900 VTK classes at startup - ✅ **Structured error reporting** - Clear error messages with suggestions --- ## Quick Start ### 1. Install the Package From PyPI (recommended once published): ```bash pip install vtkapi-mcp ``` For local development we standardize on **uv** to manage the virtualenv and extras: ```bash uv venv .venv source .venv/bin/activate uv sync --extra dev # runtime + pytest + ruff ``` > **Note:** The 64 MB `data/vtk-python-docs.jsonl` file is required at runtime but is not bundled in the wheel. Place it under `data/` (or pass `--api-docs /path/to/file`) before launching the MCP server. Prefer automation? `./setup.sh` now wraps the same uv workflow and accepts `--dev` to include the testing toolchain. ### 2. Test MCP Integration (Optional) ```bash uv run python demo_mcp_integration.py ``` This runs a complete demo showing how to use vtkapi-mcp as an MCP server (not as standalone Python library). It demonstrates all 18 MCP tools and error detection. ### 3. Developer Workflow (uv-native) | Task | Command | |------|---------| | Run unit + integration tests | `uv run pytest` | | Run tests with coverage report | `uv run pytest --cov=vtkapi_mcp --cov-report=term-missing` | | Run Ruff lint & format checks | `uv run ruff check` / `uv run ruff format --check` | > These commands automatically reuse the `.venv` created via `uv venv` / `uv sync`. No manual activation is required. ### 3. Configure MCP Client Add to your MCP settings (e…