MCP Docs Server
A Model Context Protocol (MCP) server for searching MCP protocol documentation. Built with TypeScript using the official MCP SDK.
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"
}
}
}
search_mcp_docs
Search MCP protocol documentation with ranked results.
Parameters:
query (string, required): Search query stringk (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.git
cd mcp-docs-server
npm install
Commands
npm run dev
npm test
npm run typecheck
npm run build
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