Mcp Docs Server

MCP Docs Server

A Model Context Protocol (MCP) server for searching MCP protocol documentation. Built with TypeScript using the official MCP SDK.

[npm version] [MCP Registry]

Features

• BM25 Search - High-quality ranked search using BM25 algorithm with Porter stemming
• Fast Startup - Indexes document titles at startup, fetches content on-demand
• Markdown Aware - Weights headers, code blocks, and links for better relevance
• stdio Transport - Runs as a local process for easy integration

Installation

Quick Start (Recommended)

Add to your MCP client configuration (Claude Desktop, Kiro, etc.):

{  "mcpServers": {    "mcp-docs-server": {      "command": "npx",      "args": ["-y", "@praveenc/mcp-docs-server"]    }  }}

That's it! The server will be downloaded and run automatically.

Global Install

npm install -g @praveenc/mcp-docs-server

Then configure your MCP client:

{  "mcpServers": {    "mcp-docs-server": {      "command": "mcp-docs-server"    }  }}

Tools

search_mcp_docs

Search MCP protocol documentation with ranked results.

Parameters:

• query (string, required): Search query string
• k (number, optional): Maximum results to return (default: 5). Returns fewer if fewer documents match.

Example:

{  "query": "transports",  "k": 5}

Returns:

[  {    "url": "https://modelcontextprotocol.io/specification/2025-11-25/basic/transports.md",    "title": "Transports",    "score": 15.725,    "snippet": "MCP uses JSON-RPC to encode messages..."  }]

fetch_mcp_doc

Fetch full document content by URL.

Parameters:

• uri (string, required): Document URL from modelcontextprotocol.io

Example:

{  "uri": "https://modelcontextprotocol.io/specification/2025-11-25/server/tools.md"}

Returns:

{  "url": "https://modelcontextprotocol.io/specification/2025-11-25/server/tools.md",  "title": "Tools",  "content": "# Tools\n\nTools enable servers to expose executable functionality..."}

Testing with MCP Inspector

npx @modelcontextprotocol/inspector npx -y @praveenc/mcp-docs-server

Development

Clone the repository for local development:

git clone https://github.com/praveenc/mcp-docs-server.gitcd mcp-docs-servernpm install

Commands

# Run in development modenpm run dev
# Run testsnpm test
# Type checknpm run typecheck
# Buildnpm run build
# Test with MCP Inspector (development)npm run inspect:dev

Local MCP Client Config (Development)

{  "mcpServers": {    "mcp-docs-server": {      "command": "npx",      "args": ["tsx", "/path/to/mcp-docs-server/src/index.ts"]    }  }}

Architecture

src/├── index.ts          # MCP server entry point├── config.ts         # Configuration├── tools/│   └── docs.ts       # search_mcp_docs, fetch_mcp_doc└── utils/    ├── cache.ts      # Document caching    ├── doc-fetcher.ts # HTTP fetching & HTML parsing    ├── indexer.ts    # BM25 search index    ├── logger.ts     # Logging utilities    ├── stopwords.ts  # Stop words list    ├── text-processor.ts # Text utilities    └── url-validator.ts  # URL validation

Search Algorithm

The search uses BM25 (Best Matching 25) with enhancements:

• Porter Stemming - Matches word variants (e.g., "running" → "run")
• Bigrams - Captures phrase matches (e.g., "tool input")
• Weighted Scoring:
  • Title matches: 3-8x boost
  • Header matches: 4x weight
  • Code blocks: 2x weight
  • Link text: 2x weight
• Domain Term Preservation - Technical terms like "mcp", "json", "stdio" are not stemmed

License

MIT