Monday.com MCP 服务器

一个轻量级的 MCP 服务器，用于与 Monday.com 无缝集成，使 MCP 客户端能够与 Monday.com 的看板、项目和其他资源进行交互。由 sofias tech 开发。

功能特性

该服务器通过模型上下文协议 (MCP) 提供了一个清晰的 Monday.com 资源接口，并内置缓存以提高性能。

工具

该服务器实现了以下工具：

• Get_Board_Schema: 检索 Monday.com 看板的模式，包括列、组和标签
• Get_Item_Details: 获取特定项目的详细信息，通过其 ID
• Get_Items_by_Column_Value: 基于特定列值搜索项目
• Create_Item: 在看板中指定的组内创建一个新项目
• Update_Item: 更新现有项目的列值
• Delete_Item: 从看板中删除一个项目

架构

该服务器在构建时考虑了资源效率：

• 资源管理和工具实现之间清晰分离
• 简单且可维护的代码库，每个模块少于 30 行

设置

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

快速开始

安装

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": {
    "command": "mcp-monday-server",
    "env": {
      "MONDAY_API_KEY": "your-monday-api-key",
      "MONDAY_BOARD_ID": "your-default-board-id"
    }
  }
}

使用 uvx

"mcpServers": {
  "monday": {
    "command": "uvx",
    "args": [
      "mcp-monday-server"
    ],
    "env": {
      "MONDAY_API_KEY": "your-monday-api-key",
      "MONDAY_BOARD_ID": "your-default-board-id"
    }
  }
}

开发

要求

• Python 3.10+
• requirements.txt 和 pyproject.toml 中列出的依赖项

本地开发

1. 克隆存储库
2. 创建一个虚拟环境：

   python -m venv .venv
   source .venv/bin/activate  # 在 Windows 上：.venv\Scripts\activate
   

3. 安装开发依赖项：

   pip install -e .
   

4. 创建一个 .env 文件，其中包含您的 Monday.com 凭据：

   MONDAY_API_KEY=your-monday-api-key
   MONDAY_BOARD_ID=your-default-board-id
   

5. 运行服务器：

   python -m mcp_monday_server
   

调试

要调试 MCP 服务器，您可以使用 MCP Inspector：

npx @modelcontextprotocol/inspector -- python -m mcp_monday_server

许可证

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。

版权所有 (c) 2025 sofias tech