ClickUp MCP Server

ClickUp MCP Server

site icon
2025.03.16 0
TypeScript任务管理团队协作交流协作
ClickUp MCP Server 是一个增强版的 ClickUp 任务管理服务,通过 Model Context Protocol (MCP) 为 AI 助手提供与 ClickUp 工作空间交互的能力。它提供了任务关系管理、评论 API、清单管理等功能,并改进了代码架构,使其更模块化和可维护。
View on GitHub

Overview

基本能力

产品定位

ClickUp MCP Server 是一个任务管理服务,通过 MCP 协议为 AI 助手提供与 ClickUp 工作空间交互的能力。

核心功能

  1. 任务关系管理
  2. 任务依赖关系管理
  3. 任务链接管理
  4. 任务标签管理

  5. 评论 API

  6. 任务评论管理
  7. 列表评论管理
  8. 聊天视图评论管理
  9. 线程评论管理

  10. 清单管理

  11. 任务清单创建和管理
  12. 清单项管理
  13. 嵌套清单项支持

  14. 架构改进

  15. 服务化架构
  16. 类型驱动开发
  17. 工具集成层
  18. 部署配置优化

适用场景

  • 项目管理和协作
  • 任务依赖和关系管理
  • 团队评论和沟通
  • 任务清单和子任务管理

工具列表

  1. 任务关系工具:管理任务依赖、链接和标签
  2. 评论工具:管理各种类型的评论
  3. 清单工具:管理任务清单和清单项

常见问题解答

  • 如何部署到 Railway?
  • 如何连接 Claude 或其他 AI 助手?
  • 如何扩展服务器添加新工具?

使用教程

使用依赖

  1. 安装 Node.js 和 npm
  2. 获取 ClickUp API 密钥和团队 ID

安装教程

  1. 克隆仓库 bash git clone https://github.com/v4lheru/clickup-mcp-server.git
  2. 安装依赖 bash npm install
  3. 配置环境变量 bash cp .env.example .env
  4. 构建项目 bash npm run build
  5. 运行服务器 bash node build/index.js

Railway 部署

  1. Fork 或克隆仓库到 GitHub 账户
  2. 在 Railway 上创建新项目
  3. 添加环境变量
  4. CLICKUP_API_KEY
  5. CLICKUP_TEAM_ID
  6. 部署项目

调试方式

  1. 检查服务器是否运行 bash curl http://localhost:3000
  2. 测试 API 端点 bash curl -X POST http://localhost:3000/api/tools -H "Content-Type: application/json" -d '{"tool": "list_tasks"}'

连接 Claude

  1. 打开 Claude Desktop 应用
  2. 进入 Settings > MCP Servers
  3. 添加新 MCP 服务器配置 json "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" } }

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。