quads-mcp

# quads-mcp A Model Context Protocol for QUADS ## Overview This is a Model Context Protocol (MCP) server that exposes tools, resources, and prompts for use with LLM applications like Claude. MCP servers let you extend AI applications with custom functionality, data sources, and templated interactions. ## Quick Start ### Option 1: Run with uvx (Easiest) The fastest way to run the server without any setup: ```bash # Install uv if you don't have it curl -LsSf https://astral.sh/uv/install.sh | sh # Run the server directly (from project directory) uvx --from . quads-mcp # Or run the module uvx --from . python -m quads_mcp.server ``` ### Option 2: Setup with uv (Recommended) ```bash # Set up the environment make setup # Check virtual environment status make status # Run the server (automatically uses virtual environment) make run # Run in development mode with MCP Inspector make dev # Install the server in Claude Desktop make install ``` **Note**: You don't need to manually activate the virtual environment when using `make` commands - they automatically use the `.venv` environment! If you encounter import errors, run `make reinstall` to refresh the package installation. ### Option 3: Manual Setup ```bash # Install uv if you don't have it pip install uv # Create a virtual environment uv venv # Activate the virtual environment source .venv/bin/activate # On Unix/MacOS # or .venv\Scripts\activate # On Windows # Install the package in development mode uv pip install -e . # Run in development mode mcp dev quads_mcp.server # Install in Claude Desktop mcp install quads_mcp.server ``` ### uvx Configuration When running with uvx, you can configure the server using environment variables or .env files: ```bash # Option 1: Environment variables MCP_QUADS__BASE_URL="https://your-quads-api.com/api/v3" \ MCP_QUADS__AUTH_TOKEN="your-token" \ uvx --from . quads-mcp # Option 2: .env file (recommended) cp .env.example .env # Edit .env with your configuratio…