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 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)

Clone the repository
Run the setup script:

chmod +x setup-docker.sh
./setup-docker.sh

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:

Install dependencies:

npm install

Apply the database migrations to your Supabase project:

# Use the Supabase SQL Editor to run the SQL in migrations/01_initial_setup.sql

Run the documentation scraper to populate the database:

npm run scrape

Start the server:

# 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:

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

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

A custom server that integrates WebDNA documentation with AI assistants by scraping, indexing, and providing searchable documentation through MCP-compatible API endpoints.

Related MCP Servers

mcp-ragdocs
hannesrudolph
A
security
A
license
A
quality
An MCP server implementation that provides tools for retrieving and processing documentation through vector search, enabling AI assistants to augment their responses with relevant documentation context
Last updated -
16
219
MIT License
@sanderkooger/mcp-server-ragdocs
sanderkooger
-
security
A
license
-
quality
An MCP server implementation that provides tools for retrieving and processing documentation through vector search, enabling AI assistants to augment their responses with relevant documentation context. Uses Ollama or OpenAI to generate embeddings. Docker files included
Last updated -
60
23
MIT License
API Docs MCP Server
ShotaNagafuchi
-
security
F
license
-
quality
An MCP server that crawls API documentation websites and exposes their content to AI models, enabling them to search, browse, and reference API specifications.
Last updated -
Crawl4AI MCP Server
BjornMelin
-
security
F
license
-
quality
High-performance server enabling AI assistants to access web scraping, crawling, and deep research capabilities through Model Context Protocol.
Last updated -
13

View all related MCP servers

WebDNA MCP Server