Provides navigation and exploration tools for the Model Context Protocol specification hosted on GitHub, including dynamic markdown tree generation, intelligent section search, content retrieval, and upstream synchronization with the official MCP repository.
@lepion/mcp-server-specnavigator
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.
🎯 Purpose
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
📋 Attribution
This project is based on and provides navigation for the Model Context Protocol specification created by the Model Context Protocol team. This is a wrapper/navigation tool that enhances access to the original specification.
✨ Features
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
📦 Installation
Via npm (Recommended)
From Source
Development Mode
🛠️ Available Tools
1. fetch_spec_updates
Check for upstream changes in the MCP specification repository.
Parameters:
force_refresh(boolean, optional): Force refresh even if cache is valid
Returns:
Update status and any new changes detected
2. generate_markdown_tree
Create a navigable tree structure of the MCP specification.
Parameters:
max_depth(number, optional): Maximum depth of the tree (default: 3)include_anchors(boolean, optional): Include anchor links in the tree
Returns:
Markdown-formatted tree structure with navigation links
3. find_section
Search for sections by keyword and return anchor links.
Parameters:
query(string, required): Search query for section titlesfuzzy(boolean, optional): Enable fuzzy matching (default: false)
Returns:
Array of matching sections with titles, paths, and anchor links
4. get_spec_content
Retrieve content from a specific section of the specification.
Parameters:
section_path(string, required): Path to the section (e.g., "protocol/messages")include_subsections(boolean, optional): Include subsection content
Returns:
Markdown content of the requested section
⚙️ MCP Configuration
For Claude Desktop
Add to your Claude Desktop configuration:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
For Development
🏗️ Architecture
🧪 Development
Running Tests
Linting
Formatting
🤝 Contributing
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.
📄 License
MIT License - see LICENSE file for details.
🙏 Acknowledgments
Model Context Protocol Team - For creating the MCP specification that this server navigates
Anthropic - For developing the Model Context Protocol standard
Contributors - Everyone who has contributed to improving this navigation tool
🔗 Links
NPM Package NOT AVAILABLE AT THIS POINT
Built with ❤️ by the Lepion Team