WebDNA MCP Server

# WebDNA MCP Server A state-of-the-art Model Context Protocol (MCP) server for WebDNA documentation. This server scrapes and indexes WebDNA documentation from [docs.webdna.us](https://docs.webdna.us/) and provides API endpoints for searching and retrieving documentation. ## Features - **High-Performance Documentation Access**: Efficient caching and retrieval of WebDNA documentation - **Advanced Search Capabilities**: Full-text search with relevance scoring for WebDNA instructions - **Dual Protocol Support**: Works with both stdin/stdout (for AI assistants) and HTTP interfaces - **Comprehensive MCP Tools**: Rich set of tools for exploring the WebDNA framework - **Robust Error Handling**: Graceful error recovery and detailed logging - **Optimized Database Layer**: Efficient Supabase PostgreSQL queries with caching - **Containerized Deployment**: Docker support with health checks and security best practices - **Low Resource Utilization**: Optimized for cloud deployment with minimal resource footprint ## Getting Started ### Prerequisites - Docker and Docker Compose - Supabase account and project ### Installation with Docker (Recommended) 1. Clone the repository 2. Run the setup script: ```bash chmod +x setup-docker.sh ./setup-docker.sh ``` 3. The MCP server will be available at http://localhost:3002 ### Manual Installation If you prefer not to use Docker, you can install and run the server directly: 1. Install dependencies: ```bash npm install ``` 2. Apply the database migrations to your Supabase project: ```bash # Use the Supabase SQL Editor to run the SQL in migrations/01_initial_setup.sql ``` 3. Run the documentation scraper to populate the database: ```bash npm run scrape ``` 4. Start the server: ```bash # For HTTP server npm run start:mcp-http # For stdin/stdout server (for AI assistants) npm run start:mcp ``` ## Using with Continue.dev To use this MCP server with Continue.dev, add the following to your `.continue/config.yaml` file: ```yaml mcpServers: - name: WebDNA Documentation command: curl args: - -X - POST - http://localhost:3002/mcp/invoke_tool - -H - 'Content-Type: application/json' - -d - | {"tool": "$0", "params": $1} env: SUPABASE_URL: "your-supabase-url" SUPABASE_KEY: "your-supabase-key" ``` ## MCP Tools This server provides the following enhanced MCP tools: ### search-webdna-docs Searches WebDNA documentation with advanced filtering and relevance scoring. **Parameters:** - `query` (string, required): Search query for WebDNA documentation - `category` (string, optional): Filter results by category - `limit` (number, optional): Maximum results to return (default: 20) - `offset` (number, optional): Offset for pagination (default: 0) ### get-webdna-doc Retrieves detailed documentation for a specific WebDNA instruction or context. **Parameters:** - `id` (string, required): ID, WebDNA ID, or instruction name ### get-webdna-categories Retrieves all WebDNA documentation categories with counts of instructions. ### get-random-webdna-docs Retrieves random WebDNA documentation entries for exploration. **Parameters:** - `limit` (number, optional): Number of entries to return (default: 5) ### get-webdna-stats Retrieves statistics about the WebDNA documentation database. ## API Endpoints - `GET /health`: Health check endpoint - `GET /`: API documentation and information - `POST /mcp/init`: Initialize the MCP server - `POST /mcp/list_tools`: Get available tools - `POST /mcp/invoke_tool`: Invoke a tool with parameters ## Docker Commands - `npm run docker:build`: Build the Docker container - `npm run docker:run`: Run the container - `npm run docker:up`: Start with Docker Compose - `npm run docker:down`: Stop the container - `npm run docker:logs`: View container logs ## License ISC ## Acknowledgments - [WebDNA Documentation](https://docs.webdna.us/) - [Model Context Protocol (MCP)](https://github.com/anthropics/model-context-protocol) - [Supabase](https://supabase.com/) for database infrastructure