金大哥 - mcp-spec MCP 详情

article

README

🚀 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  │
                       └──────────────────┘

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

🔧 技术细节

贡献代码

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

# 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

开发工作流程

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

社区参与

加入MCP社区讨论。

⚠️ 重要提示

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

mcp-spec