Coderide MCP

🚀 用CodeRide任務管理為你的AI助手或IDE賦能

賦予你的AI編碼助手CodeRide的強大能力！CodeRide MCP可將你喜愛的AI開發工具（如Cursor、Cline、Windsurf和其他MCP客戶端）直接連接到AI原生任務管理系統CodeRide。

想象一下，你的AI不僅能編寫代碼，還能真正理解項目上下文、管理自身任務並與你無縫協作。再也無需無盡的複製粘貼或手動更新。有了CodeRide MCP，你的AI將成為CodeRide工作流程中的重要一員。

🚀 快速開始

為何CodeRide MCP是變革性工具

• 讓AI深度理解項目：為你的AI代理提供來自CodeRide項目和任務的豐富、結構化上下文，使其能夠把握全局。
• 實現無縫的AI任務自動化：使AI能夠直接在CodeRide中獲取、解釋和更新任務，自動執行日常項目管理工作。
• 彌合人類與AI開發者之間的差距：通過更順暢的交接、一致的任務理解和協同努力，促進真正的協作。
• 優化大語言模型效率：緊湊的JSON響應可減少令牌使用量，確保AI交互更快、成本更低。
• 設計安全可靠：工作區範圍的API密鑰認證可確保數據的完整性，並將AI操作限制在正確的項目上下文中。
• 即插即用集成：在任何兼容MCP的環境中使用npx即可輕鬆設置。幾分鐘內即可讓你的AI連接就緒！
• 讓工作流程面向未來：採用基於開放模型上下文協議標準構建的AI原生開發方法。

安裝步驟

通過Smithery安裝

要通過Smithery自動為Claude Desktop安裝Coderide MCP服務器，請執行以下命令：

npx -y @smithery/cli install @PixdataOrg/coderide --client claude

讓CodeRide MCP運行並集成到你的AI代理環境中非常容易。

前提條件：

1. Node.js和npm：確保你已安裝Node.js（其中包含npm）。npx隨npm一起提供。
2. CodeRide賬戶和API密鑰：此MCP服務器專為註冊的CodeRide用戶設計。你需要一個活躍的CodeRide賬戶和一個API密鑰，你可以在app.coderide.ai的工作區設置中獲取。

MCP配置： 將以下配置添加到你的MCP客戶端（例如Claude Desktop的claude_desktop_config.json、Cursor、Cline、Windsurf、VS Code設置等）：

{
  "mcpServers": {
    "coderide": {
      "command": "npx",
      "args": [
        "-y",
        "@coderide/mcp"
      ],
      "env": {
        "CODERIDE_API_KEY": "YOUR_CODERIDE_API_KEY_HERE"
      }
    }
  }
}

重要提示：

• 請將"YOUR_CODERIDE_API_KEY_HERE"替換為你實際的CodeRide API密鑰。

配置完成後，你的MCP客戶端將自動啟動並連接到CodeRide MCP服務器，使其工具可用於你的AI與CodeRide上的項目和任務進行交互。

✨ 主要特性

核心功能

CodeRide MCP服務器為你的AI提供以下功能：

• 任務檢索：通過唯一編號獲取特定任務。
• 任務更新：修改任務描述和狀態。
• 獲取提示：獲取針對特定任務的定製提示和說明。
• 項目詳情：通過項目別名檢索項目信息。
• 項目知識管理：更新項目的知識圖譜和架構圖。
• 項目啟動：獲取項目的第一個任務以啟動工作。

適用人群

CodeRide MCP適用於：

• 使用AI編碼助手的開發者：將你的AI工具（如Cursor、Cline、Windsurf等）與CodeRide任務管理深度集成。
• 採用AI驅動開發的團隊：規範AI代理訪問項目信息和參與任務的方式。
• 任何使用MCP進行開發的人員：利用一個強大的MCP服務器示例，該服務器可連接到實際的SaaS平臺。

如果你希望讓你的AI助手成為開發團隊中更高效、更具集成性的成員，那麼CodeRide MCP就是為你準備的。

💻 使用示例

可用工具

以下是CodeRide MCP提供的工具及其使用方法：

get_task

通過任務編號（例如 "TCA-3"）檢索特定任務的詳細信息。

輸入架構：

{
  "number": "task-number (e.g., 'TCA-3')",
  "status": "to-do|in-progress|completed", // 可選：按狀態過濾
}

示例用例：

• 用戶提示：“嘿，AI，任務APP-101的詳細信息是什麼？”
• AI操作：調用get_task，參數為{ "number": "APP-101" }。
• 結果：AI獲取任務APP-101的標題、描述、狀態、優先級和其他上下文信息。

update_task

更新現有任務的描述、狀態或其他可變字段。

輸入架構：

{
  "number": "task-number-identifier",
  "description": "updated-task-description", // 可選
  "status": "to-do|in-progress|completed"   // 可選
}

示例用例：

• 用戶提示：“AI，請將任務BUG-42標記為‘已完成’，並添加備註：‘修復了差一錯誤’。”
• AI操作：調用update_task，參數為{ "number": "BUG-42", "status": "completed", "description": "Fixed the off-by-one error." }。
• 結果：任務BUG-42在CodeRide中更新。

get_prompt

檢索為AI代理處理給定任務而定製的特定提示或說明。

輸入架構：

{
  "number": "task-number (e.g., 'TCA-3')"
}

示例用例：

• 用戶提示：“AI，我準備開始處理任務ETF-7。主要目標是什麼？”
• AI操作：調用get_prompt，參數為{ "slug": "ETF", "number": "ETF-7" }。
• 結果：AI獲取FEAT-7的特定可操作提示，從而能夠明確開始工作。

get_project

使用項目別名檢索特定項目的詳細信息。

輸入架構：

{
  "slug": "project-slug (e.g., 'TCA')",
  "name": "optional-project-name" // 也可以按名稱檢索
}

示例用例：

• 用戶提示：“AI，你能給我介紹一下‘Omega Initiative’項目的概況嗎？”
• AI操作：調用get_project，參數為{ "slug": "omega-initiative" }。
• 結果：AI獲取項目的名稱、描述以及可能的知識庫或圖表鏈接。

update_project

更新項目的高級信息，如知識圖譜或系統架構圖。

輸入架構：

{
  "slug": "project-slug-identifier",
  "project_knowledge": { /* 表示知識圖譜的JSON對象 */ }, // 可選
  "project_diagram": "/* Mermaid圖表字符串或類似內容 */"             // 可選
}

示例用例：

• 用戶提示：“AI，我已經更新了用戶認證流程。請更新項目‘APB’的項目圖表。”
• AI操作：（生成/接收新圖表後）調用update_project，參數為{ "slug": "APB", "project_diagram": "/* new mermaid diagram */" }。
• 結果：CodeRide中的‘AlphaProject’現在具有更新後的架構圖。

start_project

檢索給定項目的第一個或下一個推薦任務，使AI能夠開始工作。

輸入架構：

{
  "slug": "project-slug (e.g., 'TCA')"
}

示例用例：

• 用戶提示：“AI，讓我們開始‘MobileAppV2’項目。第一個任務是什麼？”
• AI操作：調用start_project，參數為{ "slug": "MBC" }。
• 結果：AI獲取‘MBC’項目的初始任務詳細信息，準備開始工作。

🔧 技術細節

• 以工作區為中心的認證：API密鑰與特定工作區綁定。所有操作自動限定範圍，簡化請求並增強安全性。無需傳遞workspaceId！
• 用戶友好的標識符：使用人類可讀的編號（例如 "TCA-3"）和別名（例如 "TCA"）與任務和項目進行交互，而不是使用內部UUID。
• 優化響應：所有工具均返回緊湊的JSON，減少大語言模型通信的令牌使用量。
• 強大的API交互：所有操作均使用官方CodeRide API（默認https://api.coderide.ai）。

📚 詳細文檔

關於CodeRide

CodeRide是AI與人類開發者攜手合作、更快構建更好軟件的平臺。

它不僅僅是任務管理工具，更是一個從底層構建的AI原生平臺，旨在支持AI輔助軟件開發的獨特工作流程。CodeRide提供了AI代理理解複雜項目、有意義地做出貢獻並與人類同行有效協作所需的基本結構化上下文、項目知識和外部內存。

用一個真正理解人類智慧與人工智能協同作用的工具來改變你的開發過程。

在coderide.ai探索軟件開發的未來。

貢獻代碼

歡迎貢獻代碼！請隨時提交問題、分叉倉庫並創建拉取請求。

許可證

保留所有權利。詳情請參閱LICENSE文件。

支持與社區

• 對@coderide/mcp有疑問或需要幫助？請在我們的GitHub倉庫提交問題。
• 想了解更多關於CodeRide的信息？請訪問coderide.ai或加入我們的社區（如果有社區論壇/Discord鏈接）。