🚀 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：删除指定看板中的项
📦 安装指南
准备工作
- 在Monday.com中创建个人API令牌，按照Monday.com API文档中的说明操作。
- 从你的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+
本地开发步骤
- 克隆仓库：
git clone https://github.com/xxx/mcp-server-monday.git
cd mcp-server-monday
- 创建虚拟环境并安装依赖项：
python -m venv .venv
source .venv/bin/activate # 对于Windows，请使用`.venv\Scripts\activate`
pip install -r requirements.txt
- 运行服务器：
python -m mcpy
调试
可以使用以下命令检查日志：
uv task list
uv task logs
📄 许可证
此项目受MIT License保护。