clickup-operator MCP server

clickup-operator MCP server

site icon
2024.12.27 0
Python笔记管理任务管理交流协作
该服务是一个基于Claude的ClickUp操作工具,主要用于通过命令行界面与ClickUp进行交互。它提供了一个简单的笔记存储系统,支持自定义URI方案访问笔记,并能够生成笔记摘要。此外,该服务还提供了添加笔记的工具,并支持通过MCP协议与客户端通信。
View on GitHub

Overview

基本能力

产品定位

该服务是一个基于Claude的ClickUp操作工具,主要用于通过命令行界面与ClickUp进行交互。

核心功能

  1. 笔记存储系统
  2. 支持自定义note:// URI方案访问单个笔记
  3. 每个笔记资源包含名称、描述和text/plain MIME类型

  4. 提示功能

  5. summarize-notes:生成所有存储笔记的摘要

    • 可选"style"参数控制详细程度(brief/detailed)
    • 生成结合所有当前笔记和样式偏好的提示
  6. 工具功能

  7. add-note:向服务器添加新笔记
    • 需要"name"和"content"作为必需字符串参数
    • 更新服务器状态并通知客户端资源变更

适用场景

  1. 通过命令行管理ClickUp笔记
  2. 批量处理ClickUp笔记并生成摘要
  3. 开发与ClickUp集成的自动化工具

工具列表

  1. add-note
  2. 能力:向服务器添加新笔记
  3. 参数:
    • "name"(必需):笔记名称
    • "content"(必需):笔记内容

常见问题解答

  1. 调试问题
  2. 由于MCP服务器通过stdio运行,调试可能具有挑战性
  3. 推荐使用MCP Inspector进行调试

使用教程

使用依赖

  1. 需要安装Claude Desktop
  2. MacOS配置文件位置:~/Library/Application\ Support/Claude/claude_desktop_config.json
  3. Windows配置文件位置:%APPDATA%/Claude/claude_desktop_config.json

安装教程

  1. 对于开发/未发布服务器配置:
"mcpServers": {
  "clickup-operator": {
    "command": "uv",
    "args": [
      "--directory",
      "C:\Users\noahv\Documents\GitHub\create-python-server\clickup-operator",
      "run",
      "clickup-operator"
    ]
  }
}
  1. 对于已发布服务器配置:
"mcpServers": {
  "clickup-operator": {
    "command": "uvx",
    "args": [
      "clickup-operator"
    ]
  }
}

调试方式

  1. 使用MCP Inspector进行调试:
npx @modelcontextprotocol/inspector uv --directory C:\Users\noahv\Documents\GitHub\create-python-server\clickup-operator run clickup-operator
  1. 构建和发布:
uv sync
uv build
uv publish
  • 需要设置PyPI凭证:
    • Token: --tokenUV_PUBLISH_TOKEN
    • 或用户名/密码: --username/UV_PUBLISH_USERNAME--password/UV_PUBLISH_PASSWORD

许可证

None