ClickUp MCP服务器-增强型

一个全面的模型上下文协议（MCP）服务器，为人工智能助手提供完整的点击API访问。特性 170+工具, AI驱动的效率, 生产级安全，以及 完全支持GitHub风格的Markdown.

📦 快速安装: npx @chykalophia/clickup-mcp-server -无需构建！

📋 归因

🚀 主要特点

🧠 AI驱动的效率 ⭐

智能工具建议：针对最佳工作流程的情境感知建议
工作流程优化：普通工作流程效率提高50-70%
智能发现：专门构建的工具，取代低效的导航
直接访问：使用智能发现工具跳过分层导航

✅ GitHub风格的Markdown支持

支援多文本格式编写：标题、粗体、斜体、代码块、列表、表格、链接
智能内容处理：自动标记↔ 超文本标记语言↔ 纯文本转换
语法高亮显示：具有特定语言突出显示的代码块
向后兼容：现有纯文本内容继续工作

🛠️ API全面覆盖

170+工具总数 覆盖100%的主要ClickUp API端点
9个功能域：任务、评论、文档、Webhook、视图、依赖关系、附件、时间跟踪、目标
实时集成：使用HMAC验证的Webhook处理
高级工作流：依赖关系、自定义字段、批量操作

🔒 生产就绪安全

零漏洞：全面的安全审计，包含85个以上的测试用例
输入验证：XSS和消毒注射预防
速率限制：可配置阈值（1000 API，100 webhook，10上传/分钟）
HMAC验证：通过定时安全比较实现安全的webhook身份验证
文件安全：防止路径遍历、危险的文件阻塞、大小限制

🏷️ 命名空间工具名称

冲突预防：所有前缀为的工具 clickup_ 避免与其他MCP服务器发生冲突
明确标识：易于将ClickUp工具与其他服务区分开来（例如。， clickup_get_tasks vs taskmaster_get_tasks)
向后兼容：以前的工具名称已弃用，但已记录以供迁移
例子: clickup_create_task, clickup_get_workspaces, clickup_update_comment

📊 完整的工具清单（170多种工具）

🧠 效率和智能工具（20+工具）⭐

智能发现: clickup_find_chat_channels, clickup_search_views_by_name, clickup_get_workspace_overview
工作流程分析: clickup_analyze_tool_efficiency, clickup_suggest_tools_for_task
增强元数据：所有153个核心工具都增强了效率提示和替代方案

核心工作空间管理（47个工具）

工作区: clickup_get_workspaces, clickup_get_workspace_seats
空间和列表: clickup_get_spaces, clickup_get_lists, clickup_create_list, clickup_update_list, clickup_delete_list
任务: clickup_get_tasks, clickup_create_task, clickup_update_task, clickup_get_task_details （支持降价）
评论: clickup_create_task_comment, clickup_create_list_comment, clickup_create_chat_view_comment （带标记）
检查清单: clickup_create_checklist, clickup_update_checklist, clickup_create_checklist_item

高级功能域

📄 文档管理 （18个工具）：完整的CRUD、页面、共享、搜索和markdown支持
🔧 自定义字段 （15个工具）：所有字段类型、值、模板、批量操作
📎 附件 （14个工具）：上传、下载、版本、缩略图、安全验证
👁️ 视图 （13个工具）：所有视图类型、过滤器、分组、共享、自定义配置
🔗 依赖项 （12个工具）：关系、图表、冲突检测、关键路径
🎯 目标 （12个工具）：所有目标类型、目标、进度跟踪、分析
🔔 网络钩子 （11个工具）：实时处理、HMAC验证、事件历史
⏱️ 时间追踪 （10个工具）：条目、计时器、分析、团队跟踪
💬 聊天与沟通 （24个工具）：增强的聊天发现和消息传递

🚀 效率示例

智能聊天发现（速度提高60%）

代替分层导航：

// ❌ OLD WAY (4+ API calls)
clickup_get_workspaces() → clickup_get_spaces() → clickup_get_views() → filter for chat

// ✅ NEW WAY (1 API call)
clickup_find_chat_channels({ channel_name: "development" })

工作流程分析

clickup_analyze_workflow_efficiency({
  goal: "Post message to team chat",
  planned_tools: ["clickup_get_workspaces", "clickup_get_spaces", "clickup_get_views"],
  time_constraint: "urgent"
})
// Returns: Optimized workflow with 55% efficiency gain

实时Webhook处理

// Process ClickUp webhooks with HMAC validation
clickup_process_webhook({
  payload: webhookData,
  validate_signature: true,
  signature: request.headers['x-signature'],
  secret: process.env.WEBHOOK_SECRET
})
// Returns: Structured event data with relationships and changes

📝 Markdown示例

创建具有丰富描述的任务

// Task with markdown description using clickup_create_task
{
  "list_id": "123456789",
  "name": "Project Documentation",
  "description": `# Project Overview

This project implements **advanced features** for our application.

## Key Components

1. **Authentication System**
   - JWT token management
   - Role-based access control

2. **API Integration**
   - RESTful endpoints
   - Real-time updates

## Code Example

\`\`\`typescript
interface User {
  id: string;
  name: string;
  role: 'admin' | 'user';
}
\`\`\`

## Next Steps

- [x] Set up project structure
- [ ] Complete authentication module
- [ ] Implement API endpoints

> **Note**: This is a high-priority project.`
}

添加格式化评论

// Comment with markdown formatting using clickup_create_task_comment
{
  "task_id": "868f9p3bg",
  "comment_text": `## Status Update ✅

### Completed
- Authentication system implementation
- Database schema design

### In Progress
- **API Integration**: Currently working on REST endpoints

### Code Changes
\`\`\`diff
+ Added user authentication middleware
+ Implemented JWT token validation
- Removed deprecated login method
\`\`\`

**Estimated Completion**: End of week`
}

🚀 简易安装

选项1：一键安装（推荐）

下载并运行自动安装程序：

curl -O https://raw.githubusercontent.com/Chykalophia/ClickUp-MCP-Server---Enhanced/main/clickup-installer.js
node clickup-installer.js

或者通过NPX：

npx clickup-mcp-installer

选项2：Web配置程序

访问基于web的配置器进行可视化设置：点击MCP配置程序

选择您的首选版本
输入您的ClickUp API令牌
下载生成的配置文件
将其放置在Claude Desktop配置目录中

选项3:NPM包（手动设置）

使用已发布的npm包-无需构建：

@chykalophia/clickup-mcp-server

选项4：从源代码构建

对于开发或定制：

git clone https://github.com/Chykalophia/ClickUp-MCP-Server---Enhanced.git
cd ClickUp-MCP-Server---Enhanced
npm install
npm run build

获取ClickUp API令牌

登录ClickUp帐户
前往“设置”>“应用”
点击“生成API令牌”
复制令牌

配置

添加到MCP设置文件：

🚀 快速设置配置

NPM包（推荐）⭐

{
  "mcpServers": {
    "clickup": {
      "command": "npx",
      "args": ["-y", "@chykalophia/clickup-mcp-server"],
      "env": {
        "CLICKUP_API_TOKEN": "YOUR_API_TOKEN_HERE"
      }
    }
  }
}

🔧 从源代码构建（高级用户）

如果您更喜欢从源代码构建：

标准版

{
  "mcpServers": {
    "clickup": {
      "command": "node",
      "args": ["/path/to/clickup-mcp-server/build/index-enhanced.js"],
      "env": {
        "CLICKUP_API_TOKEN": "YOUR_API_TOKEN_HERE"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

增强效率版本⭐

{
  "mcpServers": {
    "clickup": {
      "command": "node",
      "args": ["/path/to/clickup-mcp-server/build/index-efficiency-simple.js"],
      "env": {
        "CLICKUP_API_TOKEN": "YOUR_API_TOKEN_HERE"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

📝 配置说明

替换 YOUR_API_TOKEN_HERE 使用您的实际ClickUp API令牌
NPM方法 无需安装或克隆-软件包会自动下载
从源代码构建 需要克隆此存储库并运行 npm run build

配置文件位置

临床VSCode扩展： ~/.vscode/extensions/saoudrizwan.claude-dev/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
克劳德桌面应用程序：

- macOS： ~/Library/Application Support/Claude/claude_desktop_config.json - 窗户： %APPDATA%\Claude\claude_desktop_config.json

例子

看 examples/ 文件夹用于：

MCP客户端的基本用法
工具集成模式
身份验证设置
高级工作流

使用以下命令运行示例： node examples/basic-usage.js

🔒 安全特性

生产级安全

输入验证：XSS和注射预防，全面消毒
API代币安全：格式验证、安全存储、字符验证
速率限制：滑动窗口实现（1000 API，100 webhook，10上传/分钟）
HMAC验证：定时安全webhook签名验证
文件安全：防止路径遍历，危险的文件阻塞，100MB大小限制
URL验证：SSRF预防、私有IP阻止、协议验证
错误处理：安全响应，无信息泄露

安全性测试

85+测试用例 涵盖所有安全场景
零漏洞 依赖性审计
综合集成测试 用于实际验证
安全标头 HTTP保护的实现

📝 Markdown支持

GitHub风格的Markdown功能

标头: # H1 通过 ###### H6
文本格式: **bold**, *italic*, ~~strikethrough~~
代码: inline code 以及带有语法高亮显示的围栏块
列表：有序、无序和任务列表 - [ ] 复选框
链接和图片: [text](url) 和 ![alt](image-url)
表格：全桌支撑，对齐
引用块: > quoted text 嵌套引号

智能处理

自动检测：标识标记、HTML或纯文本内容
双向转换：无缝标记↔ 超文本标记语言↔ 纯文本
点击优化：以ClickUp期望的格式准备内容
响应处理：将ClickUp响应转换为可读的markdown

🔔 Webhook处理

实时集成

事件处理：处理所有ClickUp事件（任务、评论、目标等）
HMAC验证：通过定时安全比较进行安全签名验证
事件分析：从有效载荷中提取关系、更改和上下文
监控：事件历史记录、统计数据和重试机制

支持的活动

任务事件：创建、更新、删除、状态更改、分配
评论事件：发布、更新、线程化讨论
时间事件：时间跟踪，计时器启动/停止
目标事件：创建、更新、目标进度
工作区事件：创建/更新/删除的列表、文件夹和空间

发展

环境要求

Node.js：版本18.x或更高
包管理器：npm或yarn
集成开发环境：建议使用支持TypeScript的VSCode

设置

# Clone and install
git clone https://github.com/Chykalophia/ClickUp-MCP-Server---Enhanced.git
cd ClickUp-MCP-Server---Enhanced
npm install

# Environment configuration
cp .env.example .env
# Edit .env with your CLICKUP_API_TOKEN

建筑

npm run build

运行测试

npm test

测试Markdown功能

# Test markdown functionality specifically
npm test -- --testPathPattern=markdown

# Run all tests with coverage
npm run test:coverage

释放过程

预发布检查表

确保所有更改都已提交并推送
验证所有测试是否通过： npm test
检查构建过程是否正常： npm run build
使用新版本详细信息更新CHANGELOG.md

版本更新过程

更新package.json版本 遵循语义版本控制：

- 主要：API变更不兼容 - MINOR：新功能（向后兼容） - 补丁：Bug修复（向后兼容）

更新CHANGELOG.md:

   ## [1.12.0] - 2025-04-14
   ### Added
   - New feature descriptions
   ### Changed
   - Modified functionality
   ### Fixed
   - Bug fixes

发布步骤

构建和测试:

   npm run build
   npm test

创建Git标签:

   git tag -a v1.12.0 -m "Release v1.12.0: Brief description"
   git push --tags

发布到NPM:

   npm publish --access public

创建GitHub版本:

   gh release create v1.12.0 --title "v1.12.0" --notes "Release notes from CHANGELOG.md"

发布后验证

检查npm包：https://www.npmjs.com/package/@chykalophia/clickup mcp服务器
验证GitHub版本：https://github.com/Chykalophia/ClickUp-MCP-Server---Enhanced/releases
测试安装： npm install @chykalophia/clickup-mcp-server@latest

🔧 技术架构

增强型客户端系统

基本客户端：具有axios集成的安全ClickUp API客户端
专业客户：针对不同功能领域的9个增强客户端
类型安全：具有Zod验证的全面TypeScript模式
错误处理：带有用户友好消息的结构化错误响应

性能和可扩展性

高效运营：对单个请求中的多个项目进行批量操作
分页支持：高效处理大型数据集
内存管理：自动清理和优化
缓存策略：优化的API使用模式

测试框架

安全测试：47个测试用例，涵盖所有攻击媒介
集成测试：15个端到端验证测试用例
错误处理测试：23个用于稳健错误处理的测试用例
总覆盖率：85多个测试用例，代码覆盖率超过80%

许可证

麻省理工学院

🎯 生产准备就绪

质量保证

安全等级：HIGH-生产批准，无漏洞
代码质量：TypeScript严格模式，全面验证
测试覆盖率：以安全为重点的测试，有85个以上的测试用例
文档：完整的安全审计指南和示例

部署功能

健康检查：内置监控端点
环境验证：安全配置验证
记录和监控：带安全事件跟踪的结构化日志记录
错误恢复：自动重试机制和冲突解决

性能指标

API呼叫减少：对通用工作流的呼叫减少50-70%
执行速度：完成时间缩短40-60%
内存效率：\<1%的安全开销，优化了资源使用
可扩展性：支持高效批处理的高并发性

______________________________________________________________________

状态: ✅ 生产就绪 -全面的ClickUp集成AI驱动的效率、生产级安全性和完整的API覆盖范围。已准备好立即部署和企业使用。

Clickup MCP Full Access

快速接入

详细介绍