MCP Server Clickup

🚀 ClickUp 操作器 MCP 服務器

ClickUp 操作器 MCP 服務器藉助 Claude 實現，能夠實現簡單的筆記存儲，支持自定義 URI 方案訪問筆記，還提供了筆記摘要生成、添加筆記等實用功能。

🚀 快速開始

安裝

Claude Desktop

• 在 MacOS 上的配置文件路徑為：~/Library/Application\ 支持/Claude/claude_desktop_config.json
• 在 Windows 上的配置文件路徑為：%APPDATA%/Claude/claude_desktop_config.json%

啟動命令

uv --directory C:\Users\noahv\Documents\GitHub\clickup-operator run clickup-operator

✨ 主要特性

資源

該服務器實現了一個簡單的筆記存儲系統，具備以下特點：

• 自定義 note:// URI 方案，可用於訪問單個筆記。
• 每個筆記資源包含名稱、描述和 text/plain 標記類型。

提示

該服務器提供了一個提示功能：

• summarize-notes：可創建所有存儲筆記的摘要。
  • 支持可選的 "style" 參數來控制詳細程度（簡潔/詳細）。
  • 能根據風格偏好生成包含所有當前筆記的提示。

工具

該服務器實現了一個工具：

• add-note：用於向服務器添加新的筆記。
  • 接受 "name" 和 "content" 作為必需的字符串參數。
  • 會更新服務器狀態並通知客戶端資源更改。

📦 安裝指南

開發與發佈流程

準備分發包

1. 同步依賴項並更新鎖定文件：

uv sync

2. 構建包發行版：

uv build

此操作將在 dist/ 目錄中創建源代碼和輪格式發行版。 3. 發佈到 PyPI：

uv publish

注意：您需要通過環境變量或命令行標誌設置 PyPI 憑證：

• 令牌：--token 或 UV_PUBLISH_TOKEN
• 或用戶名/密碼：--username/UV_PUBLISH_USERNAME 和 --password/UV_PUBLISH_PASSWORD

💻 使用示例

基礎用法

uv --directory C:\Users\noahv\Documents\GitHub\clickup-operator run clickup-operator

此命令用於啟動 ClickUp 操作器 MCP 服務器。

高級用法

啟動 MCP Inspector 進行調試

npx @modelcontextprotocol/inspector uv --directory C:\Users\noahv\Documents\GitHub\create-python-server\clickup-operator run clickup-operator

啟動後，Inspector 會顯示一個 URL，您可以在瀏覽器中訪問該 URL 開始調試。

📚 詳細文檔

配置

[待辦：添加特定於您實現的配置詳細信息]

開發

構建和發佈

為了準備分發包，需要依次執行同步依賴項、構建包發行版和發佈到 PyPI 這三個步驟，具體命令和注意事項如上述安裝指南部分所述。

調試

由於 MCP 服務器通過標準輸入輸出運行，調試可能具有挑戰性。為了獲得最佳的調試體驗，我們強烈推薦使用 MCP Inspector。通過上述高級用法中的命令啟動 MCP Inspector 後，即可在瀏覽器中進行調試操作。