ClickUp MCP Server

功能概述

增强版 ClickUp MCP 服务器提供以下功能：

• 任务关系管理：依赖关系、任务链接、标签
• 评论 API：任务、列表和聊天视图的评论功能
• 检查清单：创建和管理任务检查清单
• 原始功能：工作区导航、任务管理、列表操作等

快速设置

本地开发

# 1. 克隆仓库
git clone <repository-url>

# 2. 安装依赖
npm install

# 3. 配置环境变量
cp .env.example .env
# 编辑 .env 文件添加 CLICKUP_API_KEY 和 CLICKUP_TEAM_ID

# 4. 构建并运行
npm run build
node build/index.js

Railway 部署

1. Fork 仓库到您的 GitHub 账户
2. 在 Railway 创建新项目，选择您的 GitHub 仓库
3. 添加环境变量：
   • CLICKUP_API_KEY
   • CLICKUP_TEAM_ID
4. 部署项目

连接到 Claude

1. 打开 Claude 桌面应用程序
2. 转到设置 > MCP 服务器
3. 添加新的 MCP 服务器：

"clickup": {
  "command": "curl",
  "args": ["-s", "https://your-railway-app-url.railway.app"],
  "env": {
    "CLICKUP_API_KEY": "your_clickup_api_key_here",
    "CLICKUP_TEAM_ID": "your_clickup_team_id_here"
  }
}

扩展服务器

添加新工具步骤

1. 定义类型 (在 src/types/)
2. 实现服务方法 (在 src/services/)
3. 定义工具模式 (在 src/services/clickup-tools-integration.ts)
4. 实现工具处理程序
5. 更新主服务器 (如需要)

示例：添加工具

// 1. 在 src/types/ 中定义类型
export interface NewToolData { param1: string; param2: number; }

// 2. 在服务中实现方法
public async newToolMethod(param1: string, param2: number): Promise<any> {
  try {
    const url = `/some/api/endpoint`;
    const response = await this.axiosInstance.post(url, { param1, param2 });
    return response.data;
  } catch (error) {
    console.error('Error in new tool method:', error);
    throw error;
  }
}

// 3. 定义工具模式
{
  name: "new_tool_name",
  description: "描述该工具的作用及其使用时机",
  inputSchema: {
    type: "object",
    properties: {
      param1: { type: "string", description: "参数1描述" },
      param2: { type: "number", description: "参数2描述" }
    },
    required: ["param1"]
  }
}

// 4. 实现处理程序
case "new_tool_name": {
  const data = args as NewToolData;
  return await relationshipsService.newToolMethod(data.param1, data.param2);
}

后续步骤

• 查看完整文档了解所有可用工具
• 尝试使用任务关系API组织您的工作流
• 探索检查清单功能实现任务分解

如需详细信息，请参阅原始仓库：ClickUp MCP 服务器