Redmine

🚀 Redmine MCP 服務器用於 Cline

這是一個自定義的 MCP（模型上下文協議）服務器，它與 Redmine 集成，讓您能夠通過 Cline VS Code 擴展與 Redmine 項目和問題進行交互，為您的項目管理工作提供便利。

🚀 快速開始

在使用 Redmine MCP 服務器之前，您需要完成一系列準備工作，包括安裝必要的軟件、獲取相關密鑰以及配置環境等。

✨ 主要特性

• 與 Redmine 深度集成，可通過 Cline VS Code 擴展與 Redmine 項目和問題交互。
• 支持通過特定 URI 訪問項目。
• 可使用 JSON 配置在項目中創建問題。

📦 安裝指南

克隆倉庫

git clone https://github.com/ilask/Redmine-MCP.git
cd Redmine-MCP

安裝依賴項

npm install

📚 詳細文檔

先決條件

• Node.js：您需要安裝 Node.js（版本 18 或更高版本）。
• Redmine 實例：您需要一個運行中的 Redmine 實例，並啟用了 REST API。
• Redmine API 密鑰：您需要為您的 Redmine 用戶帳戶獲取 API 密鑰。您可以在 Redmine 賬戶設置（通常在“我的賬戶” -> “API 訪問密鑰”）中找到它。
• Cline：您需要安裝並配置好 Cline VS Code 擴展。

配置

設置環境變量

在項目根目錄下創建一個 .env 文件，並添加以下內容，用實際的 Redmine 主機名和 API 密鑰替換佔位符：

REDMINE_HOST=your-redmine-host.com
REDMINE_API_KEY=your-redmine-api-key

⚠️ 重要提示

不要將 .env 文件提交到版本控制！它包含敏感信息。此存儲庫中包含的 .gitignore 文件會阻止提交。

添加到 Cline

打開 Cline 設置

在 VS Code 中，打開 Cline 擴展並轉到 MCP 服務器選項卡。

編輯 MCP 設置

點擊“編輯 MCP 設置”以打開 cline_mcp_settings.json 文件。

添加服務器

將以下條目添加到 mcpServers 對象中，用路徑的絕對路徑替換 args 中的佔位符：

{
  "mcpServers": {
    "redmine-server": {
      "command": "node",
      "args": ["C:\\Users\\yourusername\\path\\to\\Redmine-MCP\\server.js"],
      "disabled": false,
      "autoApprove": []
    }
  }
}

⚠️ 重要提示

確保在 Windows 上使用雙反斜槓 (\\)。

保存

保存 cline_mcp_settings.json 文件。Cline 應自動檢測更改並啟動服務器。

資源和工具

資源

使用以下 URI 訪問項目：

redmine://projects
redmine://projects/{project_id}

工具

使用以下 JSON 配置在項目中創建問題：

{
  "subject": "問題主題",
  "description": "問題描述"
}

故障排除

• 連接關閉錯誤：確保 Redmine 實例的 REST API 已啟用，並且您的 API 密鑰正確。
• 檢查服務器日誌：如果遇到問題，檢查 MCP 服務器的日誌文件以獲取更多信息。

希望這份指南對您使用 Redmine MCP 服務器有所幫助！