Clickup MCP Server

🚀 ClickUp MCP 服務器交互指南

本指南將詳細介紹 ClickUp MCP 服務器，它能增強 ClickUp 管理控制檯協議 (MCP) 功能，為 AI 助手提供集成支持，助力您高效管理任務和工作流程。

🚀 快速開始

本指南將為您詳細介紹如何與 ClickUp MCP 服務器進行交互，涵蓋本地開發設置、Railway 部署、連接 AI 助手等內容。如果您有特定用例需求，如項目管理、產品開發等，也可隨時諮詢。

✨ 主要特性

增強功能

• 任務關係 API：支持創建和管理任務間的依賴關係、建立不同任務的關聯以及為任務添加自定義標籤進行分類。
• 評論 API：可在任務、列表及團隊聊天界面中進行評論的添加、編輯和刪除操作。

架構改進

• 模塊化設計：通過定義類型、服務和工具處理邏輯，實現服務器的可擴展性。
• 遵循開閉原則：新增代碼遵循開閉原則，便於後續維護和升級。

📦 安裝指南

本地開發步驟

1. 克隆代碼庫：

git clone https://github.com/v4lheru/clickup-mcp-server.git
cd clickup-mcp-server

2. 安裝依賴：

npm install

3. 配置環境變量：設置 CLICKUP_API_KEY 環境變量。
4. 啟動服務器：

npm run dev

Railway 部署步驟

1. 創建新應用並配置以下構建指令：

npm install && npm run build

2. 配置運行時指令：

npm start

3. 設置 CLICKUP_API_KEY 為密鑰。

💻 使用示例

基礎用法

// 創建任務依賴
await clickupMcp.createTaskDependency('task1', 'task2');

// 添加任務評論
await clickupMcp.addTaskComment('task1', '這是一個新的評論');

高級用法

若要擴展服務器以支持新的 ClickUp API 工具，可按以下步驟操作：

• 定義類型：

export interface NewClickupTool {
  id: string;
  name: string;
  description: string;
}

• 實現服務邏輯。

🔧 技術細節

類型定義

定義了任務關係和評論的輸入輸出數據格式，示例如下：

export interface TaskDependency {
  taskId: string;
  dependentTaskId: string;
}

服務實現

實現了與 ClickUp API 的交互邏輯，示例代碼片段如下：

public async createTaskDependency(taskId: string, dependentTaskId: string): Promise<void> {
  try {
    const url = `/tasks/${taskId}/dependencies`;
    await this.axiosInstance.post(url, { taskId: dependentTaskId });
  } catch (error) {
    console.error('創建任務依賴失敗:', error);
    throw error;
  }
}

如果您有任何問題或需要進一步的幫助，請隨時聯繫！