@lepion/mcp服务器规范导航器
](https://www.npmjs.com/package/@lepion/mcp-server-specnavigator)
一个智能MCP（模型上下文协议）服务器，用于通过动态标记树生成、智能部分导航和上游同步来导航、探索和理解模型上下文协议规范。
🎯 目的
MCP SpecNavigator服务器通过提供以下功能来改变您与MCP规范交互的方式：
- 🌳 动态Markdown树 -使用自动生成的树结构浏览规范
- 🔍 智能搜索 -通过关键字搜索和锚链接立即查找部分
- 🔄 上游同步 -随时了解最新的规范更改
- 📚 上下文文档 -按需访问特定部分
- ⚡ 性能优化 -高效缓存，快速响应
📋 归因
该项目基于并提供导航 模型上下文协议规范 由模型上下文协议团队创建。这是一个包装器/导航工具，可以增强对原始规范的访问。
✨ 特性
- 动态Markdown树生成：根据MCP规范自动生成可导航树结构
- 智能区间搜索：按关键字查找部分并获取直接锚链接
- 规范缓存：高效缓存规范以减少网络请求
- 上游同步：检查官方MCP存储库的更新
- 章节内容检索：按需获取规范的具体章节
📦 安装
通过npm（推荐）
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发展模式
# Run with hot reload
npm run dev🛠️ 可用工具
1. fetch_spec_updates
检查MCP规范存储库中的上游更改。
参数：
force_refresh（boolean，可选）：即使缓存有效，也强制刷新
退货：
- 更新状态和检测到的任何新更改
2. generate_markdown_tree
创建MCP规范的可导航树结构。
参数：
max_depth（数字，可选）：树的最大深度（默认值：3）include_anchors（布尔值，可选）：在树中包含锚链接
退货：
- 带导航链接的Markdown格式树结构
3. find_section
按关键字搜索部分并返回锚链接。
参数：
query（字符串，必填）：搜索章节标题fuzzy（布尔值，可选）：启用模糊匹配（默认值：false）
退货：
- 带有标题、路径和锚链接的匹配部分数组
4. get_spec_content
从规范的特定部分检索内容。
参数：
section_path（字符串，必填）：节的路径（例如，“协议/消息”）include_subsections（布尔值，可选）：包括小节内容
退货：
- 请求部分的Markdown内容
⚙️ MCP配置
适用于克劳德桌面
添加到您的Claude Desktop配置中：
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %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🧪 发展
运行测试
npm test代码检查
npm run lint格式化
npm run format🤝 贡献
欢迎投稿！请随时提交拉取请求。对于重大更改，请先打开一个问题来讨论您想要更改的内容。
📄 许可证
MIT许可证-请参阅 许可证 文件以获取详细信息。
🙏 致谢
- 模型上下文协议团队 -为了创建 MCP规范 此服务器导航
- Anthropic -用于开发模型上下文协议标准
- 贡献者 -所有为改进此导航工具做出贡献的人
🔗 链接
______________________________________________________________________
内置于❤️ Lepion团队