ClickUp MCP Server

基本能力

产品定位

ClickUp MCP Server 是一个用于增强 AI 助手与 ClickUp 工作空间交互的中间件服务，通过 MCP 协议提供丰富的 ClickUp API 功能。

核心功能

1. 任务关系 API 支持
2. 任务依赖关系管理
3. 任务链接管理

4. 任务标签管理

5. 评论 API 支持

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

9. 线程评论和回复

10. 检查清单 API 支持

11. 任务检查清单管理
12. 检查清单项管理

13. 嵌套检查清单项支持

14. 架构改进

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

适用场景

• 项目管理和协作
• 产品开发流程管理
• 内容日历管理
• 任务依赖和关系可视化

使用教程

使用依赖

1. Node.js 环境
2. ClickUp API Key 和 Team ID

安装教程

1. 克隆仓库 bash git clone https://github.com/v4lheru/clickup-mcp-server-2.git
2. 安装依赖 bash npm install
3. 配置环境变量 bash cp .env.example .env 然后在 .env 文件中添加您的 ClickUp API Key 和 Team ID
4. 构建项目 bash npm run build
5. 运行服务器 bash node build/index.js

Railway 部署

1. Fork 或克隆仓库到您的 GitHub 账户
2. 在 Railway 上从您的 GitHub 仓库创建新项目
3. 添加环境变量:
4. CLICKUP_API_KEY: 您的 ClickUp API key
5. CLICKUP_TEAM_ID: 您的 ClickUp team ID
6. 部署项目

调试方式

1. 确保服务器正在运行
2. 使用 curl 测试 API 端点 bash curl -s http://localhost:3000
3. 检查日志输出是否有错误信息

扩展服务器

添加新工具

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

示例: 添加时间跟踪 API

1. 创建时间跟踪类型定义
2. 实现时间跟踪服务方法
3. 创建时间跟踪工具集成
4. 更新主服务器初始化代码

许可证

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