点击Up-MCP

Name: 点击Up-MCP
Author: DiversioTeam

作者：DiversioTeam2 星标更新：2025-06-23

安装使用来源：spider==github.com

项目介绍

ClickUp MCP 服务器

这是一个模型上下文协议（MCP）服务器，使AI助手能够与ClickUp的任务管理API进行交互。该服务器通过自然语言提供了全面的任务管理能力，专注于重要的项目工作流程，而不是ClickUp的所有功能集。

由Diversio团队构建，用于简化AI驱动的任务管理。

🚀 该服务器提供什么

✅ 核心任务管理

任务CRUD操作 - 创建、读取、更新和删除任务
任务组织 - 导航空间、文件夹和列表
任务搜索与过滤 - 按各种标准查找任务
评论与协作 - 阅读和创建任务上的评论
用户与分配管理 - 列出用户，按姓名/电子邮件查找，分配给任务
状态管理 - 更新和跟踪任务状态

✅ 生产力特性

批量操作 - 一次更新或移动多个任务
时间跟踪 - 记录时间并查看已跟踪的时间
任务模板 - 从预定义模板创建任务（错误报告、功能请求、代码审查）
任务链 - 创建一系列依赖任务
团队分析 - 查看工作负载分布和完成度指标

✅ 灵活ID支持

标准ClickUp ID（abc123）
自定义ID模式（gh-123，bug-456）
ClickUp URL（https://app.clickup.com/t/abc123）
哈希格式（#123）

❌ 不包括什么

此服务器专注于任务管理的核心功能。不支持：

ClickUp 文档
白板
仪表盘
自动化/工作流
目标/目标
文件/附件管理
Webhook管理
高级自定义字段操作
日历视图
表单集成

API覆盖率： 约占ClickUp完整API的30-40%，覆盖最常见的任务管理工作流程。

安装

快速开始（推荐）

# 从GitHub安装（最新版）
uvx --from git+https://github.com/DiversioTeam/clickup-mcp clickup-mcp

# 或从PyPI安装（当发布时）
uvx clickup-mcp

开发安装

git clone https://github.com/DiversioTeam/clickup-mcp
cd clickup-mcp
uv sync
uv run clickup-mcp

配置

API密钥设置

# 设置您的ClickUp API密钥
uvx clickup-mcp set-api-key YOUR_API_KEY_HERE

# 或设置环境变量
export CLICKUP_MCP_API_KEY=your_api_key

获取您的ClickUp API密钥

分步说明：

登录到ClickUp 在 https://app.clickup.com
导航到设置：
- 点击左下角的头像/个人资料图片
- 从下拉菜单中选择“设置”
转到应用部分：
- 在左侧边栏中点击“应用”
- 然后点击“API”（或直接前往 https://app.clickup.com/settings/apps）
生成API令牌：
- 点击“生成”按钮以创建新的个人API令牌
- 重要提示：此令牌仅会显示一次！
复制并保存：
- 立即复制生成的令牌
- 安全存储（建议使用密码管理器）
- 使用以下命令配置：uvx clickup-mcp set-api-key YOUR_TOKEN_HERE

重要注意事项：

个人API令牌具有与您的用户账户相同的权限
保管好您的令牌——将其视为密码一样对待
如果丢失了令牌，您需要重新生成一个新的
令牌不会过期，但可以在同一设置页面中撤销

与AI助手一起使用

Claude Code（CLI）

添加到 ~/.config/claude-code/mcp-settings.json：

{
  "servers": {
    "clickup": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/DiversioTeam/clickup-mcp.git", "clickup-mcp"]
    }
  }
}

Claude Desktop

添加到您的Claude Desktop配置文件：

macOS：~/Library/Application Support/Claude/claude_desktop_config.json Windows：%APPDATA%\Claude\claude_desktop_config.json Linux：~/.config/claude/claude_desktop_config.json

{
  "mcpServers": {
    "clickup": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/DiversioTeam/clickup-mcp.git", "clickup-mcp"]
    }
  }
}

VS Code

VS Code通过内置集成和扩展提供了出色的MCP支持。有多种设置选项：

选项1：原生VS Code MCP（推荐）

VS Code现在具有内置的MCP支持，通过GitHub Copilot和代理模式。在您的工作区中添加：

在项目中创建 .vscode/mcp.json：

{
  "servers": {
    "clickup": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/DiversioTeam/clickup-mcp.git", "clickup-mcp"]
    }
  }
}

或添加到VS Code用户设置：

打开命令面板（Ctrl+Shift+P / Cmd+Shift+P）
运行“首选项：打开用户设置（JSON）”
添加到设置：

{
  "mcp": {
    "servers": {
      "clickup": {
        "command": "uvx",
        "args": ["--from", "git+https://github.com/DiversioTeam/clickup-mcp.git", "clickup-mcp"]
      }
    }
  }
}

选项2：具有MCP支持的VS Code扩展

Copilot MCP扩展：

从VS Code Marketplace安装“Copilot MCP”
直接从VS Code搜索、管理和安装MCP服务器
该扩展将帮助您配置ClickUp MCP服务器

Cline（AI编码助手）：

安装具有MCP支持的高级AI编码“Cline”扩展
通过Cline的设置配置ClickUp MCP服务器

在VS Code中管理MCP服务器

打开命令面板（Ctrl+Shift+P / Cmd+Shift+P）
运行“MCP：列出服务器”以查看已配置的服务器
选择ClickUp服务器以“启动/停止/重启”或查看日志
使用“MCP：显示输出”进行调试

验证VS Code设置

确保您的ClickUp API密钥已配置：uvx clickup-mcp set-api-key YOUR_KEY
在VS Code中，向GitHub Copilot询问：“你能使用MCP工具列出我的ClickUp空间吗？”
使用命令面板 → “MCP：列出服务器”检查MCP服务器状态

可用工具（28个工具）

📝 任务管理

create_task - 创建新任务
get_task - 获取任务详情（支持各种ID格式）
update_task - 更新任务属性
delete_task - 删除任务
create_task_from_template - 从预定义模板创建
create_task_chain - 创建依赖任务序列

🔍 任务发现

list_tasks - 列出任务（带过滤选项）
search_tasks - 按文本和标准搜索任务
get_subtasks - 获取父任务的所有子任务
get_task_comments - 获取任务上的评论
create_task_comment - 在任务上创建评论

👥 分配与状态

get_task_status - 获取当前任务状态
update_task_status - 更改任务状态
get_assignees - 列出任务分配人
assign_task - 将用户分配给任务

🗂️ 导航

list_spaces - 列出工作区中的所有空间
list_folders - 列出空间中的文件夹
list_lists - 列出所有列表
find_list_by_name - 按名称查找列表

⚡ 批量操作

bulk_update_tasks - 一次更新多个任务
bulk_move_tasks - 将多个任务移动到不同的列表

⏱️ 时间跟踪

get_time_tracked - 获取用户/时间段的已跟踪时间
log_time - 记录任务所花费的时间

📊 分析

get_team_workload - 查看任务在团队成员之间的分布情况
get_task_analytics - 获取速度指标和完成率

👤 用户管理

list_users - 列出工作区中的所有用户
get_current_user - 获取当前认证用户的详细信息
find_user_by_name - 按姓名或电子邮件查找用户

示例用法

自然语言命令

询问您的AI助手：

"为登录问题创建一个Development列表中的错误报告"
"显示所有分配给我的高优先级任务"
"将Sprint 1中已完成的所有任务移到存档"
"记录2小时在任务gh-123上的调试时间"
"我们团队目前的工作负载是什么？"
"创建一个任务链：设计 → 实现 → 测试 → 部署"
"在任务GH-3761上添加一条评论说'测试完成'"
"获取错误报告任务的所有评论"
"在任务abc123上添加评论并将其分配给John"

任务模板

"为支付处理问题创建一个错误报告模板"
"使用代码审查模板处理PR #456"
"为暗模式创建一个功能请求"

分析查询

"我们这个月的任务完成率是多少？"
"谁被分配的任务最多？"
"显示API项目的已跟踪时间"

开发

运行测试

# 运行所有测试（62个测试）
uv run pytest

# 带覆盖率运行
uv run pytest --cov=clickup_mcp

# 运行特定测试
uv run pytest tests/test_client.py::test_create_task

代码质量

# 检查代码风格
uv run ruff check .

# 格式化代码
uv run ruff format .

# 类型检查
uv run mypy src/

故障排除

检查配置

# 验证API密钥是否已配置
uv run clickup-mcp check-config

# 测试API连接
uv run clickup-mcp test-connection

调试模式

# 带调试日志运行
uv run clickup-mcp --debug

使用Claude Code进行本地测试

# 为本地测试添加服务器到Claude Code CLI
claude mcp add clickup-local -- uv run clickup-mcp

# 然后您可以立即测试功能
# 示例：列出空间、创建任务、添加评论等。

技术限制

速率限制：没有内置的速率限制（ClickUp：每分钟100次请求）
分页：有限的分页支持
缓存：没有实现响应缓存
自定义字段：存在模型但工具支持有限
错误恢复：基本错误处理而无复杂的重试逻辑

贡献

我们欢迎贡献！重点改进领域：

优先改进

增强错误处理和重试逻辑
实现响应缓存
更好的分页支持
扩展自定义字段支持

如何贡献

分叉仓库
创建功能分支（git checkout -b feature/improvement）
进行更改并添加测试
确保所有测试通过（uv run pytest）
运行代码检查（uv run ruff check .）
提交Pull Request

开发设置

git clone https://github.com/yourusername/clickup-mcp
cd clickup-mcp
uv sync
uv run pytest  # 确保测试通过