Clickup MCP Server Better

ClickUp MCP服务器（增强分叉）

增强型叉子 的原件 点击MCP服务器 具有附加功能和改进。

用于将ClickUp任务与AI应用程序集成的模型上下文协议（MCP）服务器。这款增强型叉子增加了 任务依赖性管理 并修复了关键参数处理问题，同时保持与原始版本的完全兼容性。

🚀 此叉子的新功能

✨ 任务依赖关系管理

• 创建依赖关系：使用waiting_on/blocking关系链接任务
• 批量依赖关系：高效地添加多个依赖项
• 依赖关系可视化：查看完整的依赖关系链
• 循环依赖预防：自动验证以防止循环
• 智能依赖解决方案：使用任务ID或名称

🔧 参数处理修复

• 修复了任务操作中的参数验证问题
• 改进了对缺少所需参数的错误处理
• 增强的参数类型检查和转换
• 更好地支持批量操作中的可选参数

🧪 增强测试

• 用于依赖操作的全面测试套件
• 基于模拟的可靠CI/CD测试
• 参数验证测试覆盖率
• 边缘案例处理验证

快速开始

NPM安装（推荐）

{
  "mcpServers": {
    "ClickUp": {
      "command": "npx",
      "args": [
        "-y",
        "@djclarkson/clickup-mcp-server@latest"
      ],
      "env": {
        "CLICKUP_API_KEY": "your-clickup-api-key-here",
        "CLICKUP_TEAM_ID": "your-clickup-team-id-here",
        "DOCUMENT_SUPPORT": "true"
      }
    }
  }
}

命令行用法

npx -y @djclarkson/clickup-mcp-server@latest --env CLICKUP_API_KEY=your-api-key --env CLICKUP_TEAM_ID=your-team-id

设置

1. 获取您的凭据：

- 来自的ClickUp API键 单击向上设置 - ClickUp工作区URL中的团队ID

1. 通过npm安装：

- 在MCP客户端中使用上述配置 - 或者直接使用npx运行

1. 开始用自然语言管理任务！

增强功能

🔗 任务依赖 新

使用自然语言创建和管理任务依赖关系：

// Create a dependency
"Make Task A depend on Task B being completed"

// View dependencies
"Show me all dependencies for Project Alpha tasks"

// Bulk dependencies
"Create dependencies: Task 1 depends on Tasks 2,3,4"

可用的依赖关系工具：

• get_task_dependencies -查看任务依赖关系链
• add_bulk_dependencies -高效地创建多个依赖关系

📝 增强的任务管理

所有原始功能加上改进的参数处理：

• ✅ 创建、更新和删除任务
• ✅ 在任何地方移动和复制任务
• ✅ 支持单次和批量操作
• ✅ 用自然语言设置开始/截止日期
• ✅ 创建和管理子任务
• ✅ 添加评论和附件
• ✅ 修复了参数验证问题

🏷️ 标签管理

• 创建、更新和删除空间标记
• 在任务中添加和删除标签
• 使用自然语言颜色命令
• 自动对比前景颜色
• 查看所有空间标签
• 基于标签的任务组织

⏱️ 时间跟踪

• 查看任务的时间条目
• 开始/停止时间跟踪
• 添加手动时间条目
• 删除时间条目
• 查看当前正在运行的计时器
• 跟踪计费和非计费时间

🌳 工作区组织

• 导航空间、文件夹和列表
• 创建和管理文件夹
• 在空间内组织列表
• 在文件夹中创建列表
• 查看工作空间层次结构
• 高效的路径导航

🧰 通用点击API访问 新

• 调用任何ClickUp端点（仪表板、文档、自定义字段、空间、标签、列表等）
• 适用于GET/POST/PUT/PATCH/DELETE
• 传递原始查询参数、标头和请求正文
• 重用共享身份验证、速率限制和错误处理

👥 成员管理

• 按姓名或电子邮件查找工作区成员
• 确定任务的指定人员
• 查看成员详细信息和权限
• 在创建和更新过程中为用户分配任务
• 支持用户ID、电子邮件或用户名

📄 文档管理

• 通过工作区列出文档
• 文档页面列表和详细信息
• 文档创建
• 文档页面更新（追加和预置）

可用工具（总计38+）

此分支包括所有原始工具和新的依赖关系管理工具：

查看完整的API参考

配置选项

HTTP传输支持

服务器支持现代 HTTP流式传输 传输（兼容MCP检查器）和传统 SSE（服务器发送事件） 运输：

{
  "mcpServers": {
    "ClickUp": {
      "command": "npx",
      "args": ["-y", "@djclarkson/clickup-mcp-server@latest"],
      "env": {
        "CLICKUP_API_KEY": "your-api-key",
        "CLICKUP_TEAM_ID": "your-team-id",
        "ENABLE_SSE": "true",
        "PORT": "3231"
      }
    }
  }
}

终点：

• 主要的，重要的: http://127.0.0.1:3231/mcp （流式HTTP）
• 遗产: http://127.0.0.1:3231/sse （SSE用于向后兼容性）

部署到smithere.ai

为了获得最稳定的smithere.ai体验，请在默认MCP端口上使用可流式传输的HTTP(3231)与 /mcp 路径。包括 smithery.yaml 已预先配置为运行smithere.ai npm run start 在容器内，露出端口 3231，并宣传 /mcp HTTP端点。

分叉差异

这个增强的fork在添加以下内容的同时，与原始版本保持了100%的兼容性：

1. 任务依赖：完整的依赖关系管理系统
2. 参数修正：解决了参数验证问题
3. 增强测试：全面的测试覆盖率
4. 更好的错误处理：改进了错误消息和验证
5. 代码质量：附加类型安全和文件

贡献

这个叉子欢迎捐款！请看 贡献.md 作为指导方针。

原始项目

许可证

MIT许可证-请参阅 许可证 了解详情。

支持

• 🐛 问题:
• 💡 特性：通过问题提交功能请求
• 🔧 原始项目: TaazKareem/clickup mcp服务器