MCP Server Monday Qi

🚀 Monday.com MCP 服務器

適用於 monday.com 的 MCP 服務器，可讓 MCP 客戶端與 monday.com 的看板、項目、更新和文檔進行交互，極大提升了與 monday.com 平臺的交互效率。

🚀 快速開始

安裝

使用 Claude Desktop（MacOS）

路徑：~/Library/Application\ Support/Claude/claude_desktop_config.json

在 Windows 上： %APPDATA%/Claude/claude_desktop_config.json

使用 uvx

"mcpServers": {
    "monday": {
        "command": "uvx",
        "args": [
            "mcp-server-monday"
        ],
        "env": {
            "MONDAY_API_KEY": "your-monday-api-key",
            "MONDAY_WORKSPACE_NAME": "your-monday-workspace-name"
        }
    }
}

使用 Docker

"mcpServers": {
    "monday-docker": {
        "command": "docker",
        "args": [
            "run", 
            "--rm", 
            "-i", 
            "-e",
            "MONDAY_API_KEY=your-monday-api-key",
            "-e",
            "MONDAY_WORKSPACE_NAME=your-monday-workspace-name",
            "sakce/mcp-server-monday"
        ]
    }
}

使用 Smithery

通過 Smithery 自動安裝適用於 Claude Desktop 的 Monday.com MCP 服務器：

npx -y @smithery/cli install @sakce/mcp-server-monday --client claude

✨ 主要特性

工具

該服務器實現了一系列強大的工具，方便用戶與 monday.com 進行交互：

• monday-create-item：可在 monday.com 看板中創建新項目或子項目。
• monday-get-board-groups：能檢索指定 monday.com 看板中的所有組。
• monday-create-update：可在 monday.com 項目上創建評論或更新。
• monday-list-boards：列出所有可用的 monday.com 看板。
• monday-list-items-in-groups：列出指定組中的所有項目。
• monday-list-subitems-in-items：列出給定 monday.com 項目的子項目。
• monday-create-board：創建新的 monday.com 看板。
• monday-create-board-group：在 monday.com 看板中創建新組。
• monday-move-item-to-group：將 monday.com 項目移動到其他組。
• monday-delete-item：刪除 monday.com 項目。
• monday-archive-item：存檔 monday.com 項目。
• monday-get-item-updates：檢索特定項目的更新/評論。
• monday-get-docs：列出 monday.com 中的文檔，可選按文件夾過濾。
• monday-get-doc-content：檢索特定文檔的內容。
• monday-create-doc：在 monday.com 創建新文檔。
• monday-add-doc-block：向現有文檔添加塊。

📦 安裝指南

1. 按照 此處 的說明創建並保存一個個人 API 令牌。
2. 從 monday.com 工作區的 URL 獲取工作區名稱。例如，如果 URL 是 https://myworkspace.monday.com/，則工作區名稱為 myworkspace。

🔧 技術細節

構建和發佈

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

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

uv sync

2. 構建包發行版：

uv build

這將在 dist/ 目錄中創建源代碼和輪分佈。 3. 發佈到 PyPI：

uv publish

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

• 令牌：--token
• 用戶名：--username

調試

使用 Inspector 進行調試：

uv run mcp-server-monday -- inspector

打開控制檯查看輸出，複製並粘貼顯示的 URL 到瀏覽器進行調試。