MCP Monday Server

🚀 Monday.com MCP 服務器

一個輕量級的MCP服務器，用於與Monday.com實現無縫集成。藉助它，MCP客戶端能夠與Monday.com的各類資源（如看板、項等）進行交互，由sofias tech開發。

🚀 快速開始

安裝

pip install -e .

或者在PyPI發佈後安裝：

pip install mcp-monday-server

使用uv：

uv pip install mcp-monday-server

Claude Desktop 集成

要在Claude Desktop中集成，更新配置文件：

• Windows：%APPDATA%/Claude/claude_desktop_config.json
• macOS：~/Library/Application\ Support/Claude/claude_desktop_config.json

標準集成

"mcpServers": {
  "monday": {
    "type": "stdio",
    "command": "python3",
    "args": ["-m", "mcpy"]
  }
}

uv 集成

uv add mcpy -- python3 -m mcpy

✨ 主要特性

此服務器通過Model Context Protocol (MCP) 提供對Monday.com資源的乾淨接口，並內置緩存功能以提高性能。

工具

該服務器實現了以下工具：

• Get_Board_Schema：獲取指定看板的模式，包括列、組和標籤
• Get_Item_Details：根據項ID獲取詳細信息
• Get_Items_by_Column_Value：根據特定列值搜索項
• Create_Item：在指定組中創建新項
• Update_Item：更新現有項的列值
• Delete_Item：刪除指定看板中的項

📦 安裝指南

準備工作

1. 在Monday.com中創建個人API令牌，按照Monday.com API文檔中的說明操作。
2. 從你的Monday.com看板URL中獲取看板ID（例如，如果URL是https://your-workspace.monday.com/boards/12345678，則看板ID為12345678）。

環境變量

服務器需要以下環境變量：

• MONDAY_API_KEY：你的Monday.com個人API令牌
• MONDAY_BOARD_ID：默認使用的看板ID

🔧 技術細節

架構

該服務器以資源效率為設計理念：

• 資源管理和工具實現分離明確
• 簡單且易於維護的代碼庫（每個模塊不超過30行）

📚 詳細文檔

開發

環境要求

• Python 3.6+

本地開發步驟

1. 克隆倉庫：

git clone https://github.com/xxx/mcp-server-monday.git
cd mcp-server-monday

2. 創建虛擬環境並安裝依賴項：

python -m venv .venv
source .venv/bin/activate  # 對於Windows，請使用`.venv\Scripts\activate`
pip install -r requirements.txt

3. 運行服務器：

python -m mcpy

調試

可以使用以下命令檢查日誌：

uv task list
uv task logs <PID>

📄 許可證

此項目受MIT License保護。