MCP Clickup Helper

🚀 MCP ClickUp 助手

MCP ClickUp 助手是一个强大的服务器，旨在简化与 ClickUp API 的交互。它采用 Model Context Protocol（MCP）进行通信，允许用户通过 MCP Client 直接查询和更新 ClickUp 中的任务，大大提升了工作效率。

🚀 快速开始

MCP ClickUp 助手能让你轻松与 ClickUp API 交互。以下为你详细介绍使用前的配置和启动步骤。

✨ 主要特性

• 查询 ClickUp 中的任务详情，让你快速获取所需信息。
• 更新任务状态，方便管理任务进度。
• 与 MCP 协议集成，支持 AI 工作流使用，提升工作自动化程度。

📦 安装指南

系统要求

• Node.js 版本 16 或更高。
• ClickUp 账户及有效的 API 密钥。
• ClickUp 团队 ID。

配置步骤

1. 克隆仓库。
2. 安装依赖：

npm install

3. 在.env 文件中设置环境变量：

CLICKUP_API_KEY=your_clickup_api_key
TEAM_ID=your_team_id

编译

运行以下命令进行项目构建：

npm run build

运行

编译后，你可以选择以下两种方式启动：

• 使用 MCP Inspector 启动，同时指定环境变量：

npx @modelcontextprotocol/inspector -e CLICKUP_API_KEY=your_api_key -e TEAM_ID=your_team_id node build/index.js

• 配置.env 文件后运行：

npx @modelcontextprotocol/inspector node build/index.js

🔧 技术细节

技术栈

• TypeScript：项目主要使用的编程语言，提供了类型检查，增强了代码的可维护性。
• Node.js：运行环境，为项目提供了高效的运行基础。
• MCP SDK：@modelcontextprotocol/sdk 用于与 MCP 协议集成，实现与 MCP Client 的通信。
• Axios：HTTP 客户端，用于与 ClickUp API 通信，方便数据的传输。
• Zod：数据验证库，确保数据的准确性和完整性。
• Dotenv：管理环境变量，方便配置项目运行所需的参数。

📄 许可证

本项目作为开源软件提供。

👨💻 贡献

欢迎各位开发者贡献代码！请随意提交 pull request 或 issue，共同完善这个项目。