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。