MCP Spec Navigator
About
Navigate and explore the Model Context Protocol specification with dynamic markdown tree generation and intelligent section navigation.
Details
- Author
- kayaozkur
- Categories
- Developer Tools, Knowledge Base
Jump to
Setup
Install MCP Spec Navigator in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/kayaozkur/mcp-server-specnavigator
Follow the installation instructions in the repository README, then restart your MCP client.
An intelligent MCP (Model Context Protocol) server for navigating, exploring, and understanding the Model Context Protocol specification with dynamic markdown tree generation, intelligent section navigation, and upstream synchronization.
The MCP SpecNavigator server transforms the way you interact with MCP specifications by providing:
- 🌳Dynamic Markdown Trees- Navigate specifications with auto-generated tree structures
- 🔍Intelligent Search- Find sections instantly with keyword search and anchor links
- 🔄Upstream Sync- Stay updated with the latest specification changes
- 📚Contextual Documentation- Access specific sections on-demand
- ⚡Performance Optimized- Efficient caching for fast responses
This project is based on and provides navigation for theModel Context Protocol specificationcreated by the Model Context Protocol team. This is a wrapper/navigation tool that enhances access to the original specification.
- Dynamic Markdown Tree Generation: Automatically generates navigable tree structures from MCP specifications
- Intelligent Section Search: Find sections by keywords and get direct anchor links
- Specification Caching: Efficiently caches specifications to reduce network requests
- Upstream Synchronization: Check for updates from the official MCP repository
- Section Content Retrieval: Get specific sections of the specification on demand
npm install -g @lepion/mcp-server-specnavigator
# Clone the repository git clone https://github.com/kayaozkur/mcp-server-specnavigator.git cd mcp-server-specnavigator # Install dependencies npm install # Build the TypeScript code npm run build # Start the server npm start
Check for upstream changes in the MCP specification repository.
- force_refresh(boolean, optional): Force refresh even if cache is valid
- Update status and any new changes detected
Create a navigable tree structure of the MCP specification.
- max_depth(number, optional): Maximum depth of the tree (default: 3)
- include_anchors(boolean, optional): Include anchor links in the tree
- Markdown-formatted tree structure with navigation links
Search for sections by keyword and return anchor links.
- query(string, required): Search query for section titles
- fuzzy(boolean, optional): Enable fuzzy matching (default: false)
- Array of matching sections with titles, paths, and anchor links
Retrieve content from a specific section of the specification.
- section_path(string, required): Path to the section (e.g., "protocol/messages")
- include_subsections(boolean, optional): Include subsection content
- Markdown content of the requested section
Add to your Claude Desktop configuration:
macOS:~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:%APPDATA%\Claude\claude_desktop_config.json
{ "mcpServers": { "specnavigator": { "command": "npx", "args": ["@lepion/mcp-server-specnavigator"], "env": { "NODE_ENV": "production" } } } }
{ "mcpServers": { "specnavigator": { "command": "node", "args": ["/path/to/mcp-server-specnavigator/dist/index.js"], "env": { "NODE_ENV": "development" } } } }
src/ ├── index.ts # Main MCP server entry point ├── spec-fetcher.ts # Handles fetching and caching specs ├── markdown-tree-generator.ts # Generates dynamic markdown trees ├── anchor-navigator.ts # Finds sections and generates anchors └── tools.ts # MCP tool definitions
Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.
MIT License - seeLICENSEfile for details.
- Model Context Protocol Team- For creating theMCP specificationthat this server navigates
- Anthropic- For developing the Model Context Protocol standard
- Contributors- Everyone who has contributed to improving this navigation tool
- NPM PackageNOT AVAILABLE AT THIS POINT
- GitHub Repository
- Model Context Protocol Specification
- Report Issues
This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.
One shared context layer for AI agents and humans — live API specs, DB schemas, and versioned contracts across repos so every agent and teammate works from the same source of truth.
Local stdio MCP server that lets AI coding agents read and maintain structured architecture, rules, and decisions directly from your repository.
Official Context7 MCP server that brings up-to-date, version-specific library documentation and code examples into AI coding prompts.
Remote, no-auth MCP server providing AI-powered codebase context and answers
Create and read feature flags, review experiments, generate flag types, search docs, and interact with GrowthBook's feature flagging and experimentation platform.
Official MCP server for Stimulsoft Reports & Dashboards documentation. Semantic search across FAQ, Programming Manual, Server/User Manual, and Server/Cloud API for .NET, WPF, Avalonia, WEB, Blazor, Angular, React, JS, PHP, Java, and Python platforms.
Search Apple's Developer Documentation with smart search and wildcard support.
Access documentation from the Awesome-llms-txt repository directly in your conversations.
Connect AI tools like Cursor and VS Code to your product documentation using the Biel.ai platform.
MCP server that ingests project docs once and lets Claude search by meaning instead of reading everything — saving tokens on large codebases
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
