Nazruden Clickup MCP Server

🚀 ClickUp MCP 服務器

這是一個與 ClickUp 集成的 MCP 協議服務器實現，它能讓 AI 助手與 ClickUp 工作區進行交互，為工作流程的自動化和智能化提供支持。

🚀 快速開始

1. 配置Claude for Desktop：

{
  "mcpServers": {
    "clickup": {
      "command": "npx",
      "args": ["@mcp/clickup-server"],
      "env": {
        "CLICKUP_CLIENT_ID": "your_client_id", // 替換為你的ClickUp客戶端ID
        "CLICKUP_CLIENT_SECRET": "your_client_secret", // 替換為你的ClickUp客戶端密鑰
        "CLICKUP_REDIRECT_URI": "http://localhost:3000/oauth/callback" // 默認重定向URI
      }
    }
  }
}

2. 重啟Claude for Desktop。

完成！服務器將在需要時自動下載並啟動。

📦 安裝指南

環境變量

必填環境變量：

• CLICKUP_CLIENT_ID：你的ClickUp OAuth客戶端ID
• CLICKUP_CLIENT_SECRET：你的ClickUp OAuth客戶端密鑰
• CLICKUP_REDIRECT_URI：OAuth重定向URI（默認：http://localhost:3000/oauth/callback）

可選環境變量：

• PORT：服務器端口（默認：3000）
• LOG_LEVEL：日誌級別（默認：info）

開發步驟

1. 克隆倉庫：

git clone [倉庫地址]

2. 安裝依賴：

npm install

3. 啟動開發模式：

npm run dev

4. 構建生產版本：

npm run build

5. 運行測試：

npm test

✨ 主要特性

可用工具

任務管理

• clickup_create_task：在ClickUp列表中創建新任務
• clickup_update_task：更新現有任務的屬性

團隊與列表管理

• clickup_get_teams：獲取所有可訪問的團隊
• clickup_get_lists：獲取特定文件夾中的所有列表

看板管理

• clickup_create_board：在ClickUp空間中創建新看板

安全特性

• 所有令牌均加密存儲
• 使用OAuth2流程實現安全認證
• 不記錄敏感數據
• 實現速率限制以防止API濫用

📚 詳細文檔

常見問題

認證錯誤

• 驗證環境變量中的OAuth憑證是否正確配置
• 檢查令牌的有效期
• 確保重定向URI匹配

速率限制

• 服務器已實現自動速率限制處理
• 查看日誌中關於速率限制的警告信息
• 考慮批量請求以減少限制影響

服務器未啟動

• 檢查環境變量是否配置正確
• 確保端口3000可用
• 查看Claude for Desktop的日誌

獲取日誌

Claude for Desktop的日誌路徑如下：

• Windows：%USERPROFILE%\AppData\Local\Claude\Logs\mcp*.log
• macOS：~/Library/Logs/Claude/mcp*.log

📄 許可證

MIT License - 請參閱LICENSE文件瞭解詳細信息