Noahvanhart MCP Server Clickup

🚀 點擊上升操作符 MCP 服務器

本項目藉助Claude實現了Clickup相關功能，構建了一個簡單的筆記存儲系統，支持自定義URI方案訪問筆記，還能生成筆記摘要、添加新筆記等。

🚀 快速開始

安裝

Claude Desktop

• 在 MacOS 上：配置文件路徑為 ~/Library/Application\ Support/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：可生成所有存儲筆記的摘要。
  • 支持可選的“風格”參數來控制詳細程度（簡潔/詳細）。
  • 會根據風格偏好生成結合所有當前筆記的提示。

工具

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

• add-note：可向服務器添加新的筆記。
  • 接受“名稱”和“內容”作為必需的字符串參數。
  • 會更新服務器狀態並通知客戶端資源更改。

📦 安裝指南

構建和發佈

若要準備將包進行分發，可按以下步驟操作：

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

uv sync

2. 構建包分發：

uv build

此操作將在 dist/ 目錄中創建源代碼和 wheel 分發。 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

高級用法

構建和發佈包

# 同步依賴項並更新鎖定文件
uv sync
# 構建包分發
uv build
# 發佈到 PyPI
uv publish

調試

由於MCP服務器通過標準輸入輸出運行，調試可能會有挑戰。為獲得最佳調試體驗，強烈推薦使用 MCP 調查員。 您可以使用 npm 通過以下命令啟動MCP Inspector：

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

啟動後，調查員將在瀏覽器中顯示一個URL，您可以在其中開始調試。