mcp-docs-server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-docs-server search for transports in MCP documentation"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
Related MCP server: Markdown RAG MCP
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-serverThen 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 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-serverDevelopment
Clone the repository for local development:
git clone https://github.com/praveenc/mcp-docs-server.git
cd mcp-docs-server
npm installCommands
# Run in development mode
npm run dev
# Run tests
npm test
# Type check
npm run typecheck
# Build
npm run build
# Test with MCP Inspector (development)
npm run inspect:devLocal 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 validationSearch 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
Available Tools
2 toolsfetch_mcp_docA
Fetch full document content by URL from MCP protocol documentation. Only URLs from modelcontextprotocol.io are allowed.
Inputs: uri (required).
search_mcp_docsA
Search MCP protocol documentation with ranked results. Uses BM25 ranking with Porter stemming for high-quality search.
Inputs: query (required), k.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
The two tools have clearly distinct purposes: one fetches a specific document by URL, the other searches across documents. No overlap in functionality.
Both tool names follow a consistent verb_noun pattern (fetch_mcp_doc, search_mcp_docs) and use snake_case uniformly.
With only two tools, the server is minimal but still covers the core operations of searching and fetching documentation. However, it feels slightly thin for a documentation server.
The server allows searching and fetching full documents, but lacks operations like listing all available documents or browsing by category, which are common in documentation servers.
Maintenance
Related MCP Connectors
Search DeveloperHub's own documentation. Every docs site hosted on DeveloperHub serves one at /mcp
Search and read the Metabind documentation: MCP Apps, BindJS, the SDKs, the CLI, and the APIs.
Search and read the official MintMCP documentation, the enterprise MCP gateway.
Read-only MCP server for the OrchestKit docs: full-text search + Markdown fetch. No auth.
Related MCP Servers
- AlicenseAqualityDmaintenanceProvides searchable access to official MCP protocol specification and FastMCP framework documentation, helping developers build correct MCP servers by querying live documentation with BM25 full-text search.23MIT
- AlicenseNot gradedqualityDmaintenanceProvides semantic search over markdown documentation using RAG, allowing natural language queries and integration with MCP clients.1MIT
- AlicenseAqualityBmaintenanceSearch and retrieve Agent2Agent (A2A) protocol documentation using full-text search and section filtering.2MIT
- FlicenseNot gradedqualityDmaintenanceMCP server for searching and retrieving Akamai TechDocs documentation using local BM25 keyword search with no external API calls.-