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保护。