clickup-operator MCP server

clickup-operator MCP server

site icon
2024.12.03 4
Python笔记管理协作工具交流协作
mcp-server-clickup 是一个通过 Claude 实现的 ClickUp 操作服务,主要用于笔记的存储和管理。它提供了自定义的 note:// URI 方案来访问单个笔记,每个笔记资源都有名称、描述和纯文本类型。此外,该服务还提供了笔记摘要生成和添加新笔记的功能。
View on GitHub

Overview

基本能力

产品定位

mcp-server-clickup 是一个用于笔记存储和管理的服务,通过 Claude 实现 ClickUp 操作。

核心功能

  • 自定义 note:// URI 方案访问单个笔记
  • 每个笔记资源包含名称、描述和纯文本类型
  • 提供 summarize-notes 提示,用于生成所有存储笔记的摘要
  • 可选 "style" 参数控制详细程度(brief/detailed)
  • 提供 add-note 工具,用于添加新笔记
  • 需要 "name" 和 "content" 作为必需字符串参数
  • 更新服务器状态并通知客户端资源更改

适用场景

  • 需要集中管理和访问笔记的场景
  • 需要自动生成笔记摘要的场景
  • 需要动态添加和管理笔记的场景

工具列表

  • add-note: 添加新笔记到服务器
  • 能力:接收名称和内容作为参数,更新服务器状态并通知客户端

常见问题解答

  • 调试困难:建议使用 MCP Inspector 进行调试

使用教程

使用依赖

  • 需要安装 Claude Desktop
  • MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%/Claude/claude_desktop_config.json

安装教程

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

  4. 构建和发布

  5. 同步依赖并更新锁文件: bash uv sync
  6. 构建包分发: bash uv build
  7. 发布到 PyPI: bash uv publish

调试方式

  • 使用 MCP Inspector 进行调试: bash npx @modelcontextprotocol/inspector uv --directory C:\\Users\\noahv\\Documents\\GitHub\\create-python-server\\clickup-operator run clickup-operator

许可证

None