API Docs MCP Server

An MCP server for crawling API documentation websites and exposing their content through the Model Context Protocol. This allows AI models to search, browse, and reference API specifications.

Features

• Crawls API documentation websites to extract structured information
• Exposes API docs as resources through MCP
• Provides search tools for finding specific API endpoints
• Includes prompt templates for common API documentation tasks
• Stores crawled data for offline access

Installation

# Create and activate a virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install the package
pip install -e .

Usage

Starting the server

python -m src.main --url https://example-api-docs.com

Connecting to the server

This MCP server can be connected to any MCP client, such as Claude for Desktop. Configure your client to use this server with:

{
  "api-docs": {
    "command": "python",
    "args": ["-m", "src.main", "--url", "https://example-api-docs.com"]
  }
}

MCP Capabilities

Resources

• API endpoint specifications
• Data models and schemas
• API examples and code snippets

Tools

• search_api: Search for API endpoints by name, path, or description
• get_endpoint_details: Get detailed information about a specific endpoint
• list_endpoints: List all available API endpoints
• find_examples: Find examples for a specific API endpoint

Prompts

• explain_endpoint: Generate a natural language explanation of an API endpoint
• compare_endpoints: Compare two API endpoints
• generate_code: Generate sample code for using an API endpoint

License

MIT