项目简介

ClickUp Operator MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在将 ClickUp 项目管理工具集成到 LLM 应用中。通过此服务器，LLM 客户端可以调用 ClickUp 的各项功能，例如任务管理、团队协作、时间跟踪等，从而实现更智能的工作流程自动化。

主要功能点

• 工具 (Tools): 提供了丰富的 ClickUp API 工具，包括：
  • 获取团队、空间、列表、任务信息
  • 创建和管理任务、空间、文件夹、列表、评论、清单、标签等
  • 时间跟踪功能（开始、停止、获取时间条目）
  • 团队和用户管理功能（邀请用户、客人，管理团队成员）
  • Webhook 管理
• 资源 (Resources): 当前版本主要聚焦于通过工具与 ClickUp API 交互，资源管理功能未在代码中实现。
• Prompt 模板 (Prompts): 当前版本未提供 Prompt 模板功能。

安装步骤

1. 安装 Python 和 uv: 如果尚未安装，请先安装 Python 和 uv 包管理器。uv 可以使用 pip 安装：'pip install uv'。
2. 克隆仓库: 将 GitHub 仓库 'https://github.com/noahvanhart/mcp-server-clickup' 克隆到本地。
3. 安装依赖: 在仓库根目录下运行 'uv sync' 命令安装项目依赖。
4. 配置 ClickUp API 密钥:
   • 在仓库根目录下创建 '.env' 文件。
   • 在 '.env' 文件中添加 'CLICKUP_API_TOKEN=你的_ClickUp_API_密钥'，将 '你的_ClickUp_API_密钥' 替换为你的 ClickUp API 密钥。

服务器配置

要将此 MCP 服务器配置到 MCP 客户端（例如 Claude），您需要提供服务器的启动命令和参数。以下是配置信息，请添加到 MCP 客户端的配置文件中：

{
  "mcpServers": {
    "clickup-operator": {
      "command": "uv",
      "args": [
        "--directory",
        "你的仓库路径/clickup-operator",  // 请替换为你的仓库本地路径，例如：/Users/yourname/Documents/GitHub/mcp-server-clickup/clickup-operator
        "run",
        "clickup-operator"
      ]
    }
  }
}

注意: 请将 '"你的仓库路径/clickup-operator"' 替换为克隆到本地的 'clickup-operator' 仓库的实际路径。MCP 客户端（如 Claude）会根据此配置启动 MCP 服务器。

基本使用方法

1. 启动 MCP 服务器: MCP 服务器会在 MCP 客户端（如 Claude）启动时自动运行。
2. 在 LLM 客户端中使用工具: 在支持 MCP 协议的 LLM 客户端中，您应该能够发现并使用 'clickup-operator' 提供的工具。根据工具的描述和参数，您可以指示 LLM 调用相应的 ClickUp 功能。例如，您可以让 LLM “创建一个名为 ‘Project X’ 的 ClickUp 任务在 ‘待办列表’ 中”。