使用说明

项目简介

clickup-operator MCP 服务器是一个基于 Model Context Protocol (MCP) 的应用后端，旨在通过 Claude 等 MCP 客户端，为用户提供便捷的 ClickUp 工作空间管理能力。它通过标准化的 MCP 协议，将 ClickUp 的各项功能封装成易于 LLM 调用的工具，从而实现智能化的任务管理和工作流程自动化。

主要功能点

丰富的 ClickUp 工具集: 提供了全面的 ClickUp API 工具，包括：
- 工作空间管理: 获取团队/工作区信息、创建和管理空间、团队用户组等。
- 项目与任务管理: 创建、查询、更新和删除任务、清单、文件夹和列表。
- 协作功能: 评论管理、任务依赖、添加/移除观察者和成员、邀请访客和用户。
- 时间跟踪: 启动、停止、查询和管理时间条目。
- 自定义字段与标签: 获取自定义字段、管理空间标签和时间条目标签。
- Webhook: 创建、获取、更新和删除 Webhook。

安装步骤

安装 Python 依赖: 确保你的 Python 环境已安装 'uv' 包管理器。如果未安装，请先安装 'uv'。
```
pip install uv
```
同步依赖: 使用 'uv sync' 命令安装项目依赖。
```
uv sync
```
这将会根据 'uv.lock' 文件安装项目所需的所有 Python 包。

服务器配置

要将此 MCP 服务器添加到 MCP 客户端（例如 Claude），你需要配置服务器的启动命令。以下是配置信息，请复制到你的 MCP 客户端的配置文件中（例如 Claude Desktop 的 'claude_desktop_config.json'）：

开发/未发布服务器配置 (Development/Unpublished Servers Configuration)

"mcpServers": {
  "clickup-operator": {
    "command": "uv",
    "args": [
      "--directory",
      "你的仓库路径/noahvanhart_mcp-server-clickup/src",  //  请替换为你的仓库在本地的实际路径，指向 src 目录
      "run",
      "clickup_operator" //  运行 clickup_operator 包
    ]
  }
}

注意:

请将 '"你的仓库路径/noahvanhart_mcp-server-clickup/src"' 替换为你本地仓库 'src' 目录的绝对路径。
确保你已设置名为 'CLICKUP_API_TOKEN' 的环境变量，其值为你的 ClickUp API 令牌。你需要在 ClickUp API 设置中获取 API 令牌。

基本使用方法

启动 MCP 服务器: MCP 客户端（如 Claude）在配置完成后会自动启动该 MCP 服务器。
在 MCP 客户端中使用工具: 在 MCP 客户端中，你可以通过自然语言指令调用 clickup-operator MCP 服务器提供的工具，例如：
- "列出我的 ClickUp 工作区" (对应 'get-teams' 工具)
- "在 '工作项目' 工作区创建一个名为 '新项目计划' 的空间" (对应 'create-space' 工具，需要提供 'team_id' 和 'name' 参数)
- "为任务 ID '任务123' 添加评论 '进度更新'" (对应 'create-task-comment' 工具，需要提供 'task_id' 和 'comment_text' 参数)
客户端会解析你的指令，并根据工具的输入 Schema 引导你提供必要的参数。服务器执行工具后，会将结果以文本形式返回给客户端。

通过以上步骤，你就可以利用 clickup-operator MCP 服务器，在支持 MCP 协议的客户端中，方便快捷地管理你的 ClickUp 工作空间和项目了。

关键词