Mcp Spec

🚀 MCP规范服务器

MCP规范服务器将模型上下文协议文档转化为一个MCP服务器，让你的大语言模型（LLM）能够获取完整的MCP规范上下文。你可以查询特定的部分，如“工具”“资源”“授权”等20多个部分，以获取该部分的完整文档。

🚀 快速开始

将此服务器添加到任何与MCP兼容的客户端（Claude桌面版、Cursor、VSCode、Windsurf等）：

Claude桌面版配置

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

Cursor配置

在聊天设置的“工具/集成”中编辑 mcp.json

{
"mcpServers": {
"mcp-spec": {
"command": "npx",
"args": ["-y", "@mcpjam/mcp-spec@latest"]
}
}
}

✨ 主要特性

📚 完整的MCP规范访问

• 索引并可搜索364KB的全面MCP文档
• 涵盖协议各个方面的25+个不同部分
• 返回完整的部分内容，而非片段

⚡ 智能文档处理

• 按主要标题（# 标签）进行智能分块
• 每个块限制为500行，以实现最佳性能
• 快速启动索引（<1秒）

🔧 面向开发者的部分

• 工具 - 函数调用和工具执行模式
• 资源 - 数据访问和资源管理
• 授权 - 安全、身份验证和授权
• 传输 - 通信层（标准输入输出、HTTP、服务器发送事件）
• 调试 - 故障排除和开发工具
• 核心组件 - 协议架构基础
• 连接生命周期 - 初始化和终止
• 以及18个以上的专业部分

🛠️ 专为MCP开发而构建

• 非常适合构建MCP服务器或客户端的开发者
• 提供参考实现模式和最佳实践
• 让你能够随时获取完整的协议规范

💻 使用示例

基本的工作原理

┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│   MCP Client    │◄──►│  MCP Spec Server │◄──►│ Specification   │
│   (Claude,      │    │                  │    │ Document        │
│    Your App)    │    │  - Section Index │    │ (llms-full.md)  │
└─────────────────┘    │  - Content Cache │    └─────────────────┘
│  - Search Logic  │
└──────────────────┘

1. 服务器在启动时对完整的MCP规范进行索引。
2. 文档按主要标题拆分为多个部分。
3. 通过部分名称进行查询，以获取该部分的完整内容。
4. 返回诸如“工具”“资源”“授权”等主题的完整文档。

🔧 技术细节

贡献代码

如果你想改进这个服务器，可以按照以下步骤操作：

# 1. 克隆仓库
git clone https://github.com/your-org/mcp-spec.git
cd mcp-spec

# 2. 安装依赖
npm install

# 3. 构建项目
npm run build

# 4. 启动开发服务器
npm run dev

开发工作流程

1. 分叉此仓库。
2. 创建一个功能分支：git checkout -b my-feature。
3. 进行更改。
4. 在本地进行测试：npm run build && npm run dev。
5. 提交拉取请求。

社区参与

加入MCP社区讨论。

⚠️ 重要提示

这是一个非官方服务器，旨在让MCP规范更易于访问。如需官方MCP资源和文档，请访问 modelcontextprotocol.io。