ClickUp MCP Server

带有超级网关的 ClickUp MCP 服务器

此集成通过 Supergateway 运行 ClickUp MCP 服务器，将其公开为可供 n8n 节点或其他客户端使用的 SSE 端点。

先决条件

• Node.js 18 或更高版本
• Docker 和 Docker Compose（用于容器化部署）
• ClickUp API 密钥和团队 ID

本地开发

使用 Node.js 运行

1. 安装依赖项：
   npm install -g supergateway @taazkareem/clickup-mcp-server
2. 设置环境变量：
   export CLICKUP_API_KEY=pk_94547006_D8DFEXXFDOX7RUOJBBPLM2BSVRFXPZE9 export CLICKUP_TEAM_ID=2357720
3. 运行集成脚本：
   ./run-clickup-mcp.sh
4. 自定义配置（可选）：
   ./run-clickup-mcp.sh --port 9000 --base-url http://example.com --cors "http://localhost:8080,http://localhost:3000"

使用 Docker Compose 运行

1. 根据.env.example创建.env文件：
   cp .env.example .env
2. 使用您的 ClickUp API 密钥和团队 ID 编辑.env文件。
3. 启动容器：
   docker-compose up -d
4. 查看日志：
   docker-compose logs -f

部署到铁路

1. 在 Railway 上创建一个新项目。
2. 连接您的 GitHub 存储库或使用 Railway CLI 进行部署。
3. 在 Railway 中设置以下环境变量：
   • CLICKUP_API_KEY ：您的 ClickUp API 密钥
   • CLICKUP_TEAM_ID ：您的 ClickUp 团队 ID
   • PORT ：8000（或您首选的端口）
   • BASE_URL ：您的 Railway 应用 URL（例如https://your-app-name.up.railway.app ）
   • SSE_PATH ：/sse（或您的首选路径）
   • MESSAGE_PATH ：/message（或您的首选路径）
   • LOG_LEVEL ：信息（或调试以获得更详细的日志记录）
   • DOCUMENT_SUPPORT ：false（或根据需要为 true）
   • CORS_ORIGINS ：*（或以逗号分隔的允许来源列表）
4. 部署应用程序。

与 n8n 一起使用

1. 在 n8n 中，添加一个新的“MCP”节点。
2. 使用以下设置配置节点：
   • 服务器 URL：您的 Railway 应用程序 URL + SSE 路径（例如，https: //your-app-name.up.railway.app/sse ）
   • 消息路径：您的消息路径（例如，/message）
3. 从可用工具中选择所需的 ClickUp 工具。
4. 根据需要配置工具参数。
5. 将节点连接到您的工作流程。

API 端点

• SSE 端点： {BASE_URL}{SSE_PATH} （例如， http://localhost:8000/sse ）
  • 方法：GET
  • 描述：订阅服务器发送的事件
• 消息端点： {BASE_URL}{MESSAGE_PATH} （例如， http://localhost:8000/message ）
  • 方法：POST
  • 描述：发送消息到服务器
  • 内容类型：application/json
  • 正文：JSON-RPC 2.0 格式的消息
• 健康检查端点： {BASE_URL}/healthz （例如， http://localhost:8000/healthz ）
  • 方法：GET
  • 描述：检查服务是否正常运行
  • 响应：如果服务正常，则返回“ok”

故障排除

• 连接问题：确保您的防火墙允许连接到指定的端口。
• 身份验证错误：验证您的 ClickUp API 密钥和团队 ID 是否正确。
• CORS 错误：配置 CORS_ORIGINS 环境变量以包含客户端的来源。