MCP Spec

🚀 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. Fork此仓库。
2. 创建一个功能分支：git checkout -b my-feature。
3. 进行修改。
4. 在本地进行测试：npm run build && npm run dev。
5. 提交拉取请求。

社区参与

加入MCP社区讨论。

⚠️ 重要提示

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