
ClickUp MCP Server

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 工作空间交互的能力。
核心功能
- 任务关系管理
- 任务依赖关系管理
- 任务链接管理
-
任务标签管理
-
评论 API
- 任务评论管理
- 列表评论管理
- 聊天视图评论管理
-
线程评论管理
-
清单管理
- 任务清单创建和管理
- 清单项管理
-
嵌套清单项支持
-
架构改进
- 服务化架构
- 类型驱动开发
- 工具集成层
- 部署配置优化
适用场景
- 项目管理和协作
- 任务依赖和关系管理
- 团队评论和沟通
- 任务清单和子任务管理
工具列表
- 任务关系工具:管理任务依赖、链接和标签
- 评论工具:管理各种类型的评论
- 清单工具:管理任务清单和清单项
常见问题解答
- 如何部署到 Railway?
- 如何连接 Claude 或其他 AI 助手?
- 如何扩展服务器添加新工具?
使用教程
使用依赖
- 安装 Node.js 和 npm
- 获取 ClickUp API 密钥和团队 ID
安装教程
- 克隆仓库
bash git clone https://github.com/v4lheru/clickup-mcp-server.git
- 安装依赖
bash npm install
- 配置环境变量
bash cp .env.example .env
- 构建项目
bash npm run build
- 运行服务器
bash node build/index.js
Railway 部署
- Fork 或克隆仓库到 GitHub 账户
- 在 Railway 上创建新项目
- 添加环境变量
- CLICKUP_API_KEY
- CLICKUP_TEAM_ID
- 部署项目
调试方式
- 检查服务器是否运行
bash curl http://localhost:3000
- 测试 API 端点
bash curl -X POST http://localhost:3000/api/tools -H "Content-Type: application/json" -d '{"tool": "list_tasks"}'
连接 Claude
- 打开 Claude Desktop 应用
- 进入 Settings > MCP Servers
- 添加新 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" } }