monday.com MCP Server

一个 Model Context Protocol（MCP） 服务实现，提供与 monday.com API 交互的接口。

💻 Claude Desktop 演示

https://github.com/user-attachments/assets/ed8d24e1-256b-4f6b-9d84-38e54a8703fd

前置条件

运行 MCP 服务前，请确保已安装：

1. Node v20 或更高版本
2. NPM v5.2.0 或更高版本
3. monday.com API 密钥

⚙️ 使用方法

npx @mondaydotcomorg/monday-api-mcp@latest -t abcd123

也可以通过 monday_token 环境变量提供 monday.com API 令牌。

命令行参数

参数	标志	描述	必填	默认值
monday.com API 令牌	--token、-t	monday.com API 令牌（也可以通过 monday_token 环境变量提供）	是	-
API 版本	--version、-v	monday.com API 版本	否	current
只读模式	--read-only、-ro	启用只读模式	否	false
模式	--mode、-m	设置工具选择模式："api" - 仅 API 工具，"apps" -（Beta）仅 Monday Apps 工具，"atp" -（Alpha）ATP 服务模式	否	api
动态 API 工具	--enable-dynamic-api-tools、-edat	（Beta）启用动态 API 工具（包含整个 API 架构的模式；只读模式下不支持）	否	false

🧪 ATP 模式（Alpha）

ATP（Agent Tool Protocol）模式提供另一种集成方式，支持 GraphQL API 探索和代码执行。此模式提供两个强大的工具：

• explore_api：浏览和发现 monday.com GraphQL API 结构
• execute_code：执行 JavaScript 代码，动态调用 monday.com API

⚠️ Alpha 功能：ATP 模式目前处于 alpha 阶段。API 和行为可能会发生变化。

使用方法

npx @mondaydotcomorg/monday-api-mcp@latest -t abcd123 -m atp

Cursor 集成（ATP 模式）

{
  "mcpServers": {
    "monday-api-mcp": {
      "command": "npx",
      "args": [
        "@mondaydotcomorg/monday-api-mcp@latest",
        "-t",
        "abcd123",
        "-m",
        "atp"
      ],
      "env": {
        "NODE_OPTIONS": "--no-node-snapshot"
      }
    }
  }
}

💻 Claude Desktop 集成

{
  "mcpServers": {
    "monday-api-mcp": {
      "command": "npx",
      "args": [
        "@mondaydotcomorg/monday-api-mcp@latest",
        "-t",
        "abcd123"
      ]
    }
  }
}

💻 Cursor 集成

使用命令行参数

{
  "mcpServers": {
    "monday-api-mcp": {
      "command": "npx",
      "args": [
        "@mondaydotcomorg/monday-api-mcp@latest",
        "-t",
        "abcd123"
      ],
      "env": {}
    }
  }
}

使用环境变量

{
  "mcpServers": {
    "monday-api-mcp": {
      "command": "npx",
      "args": [
        "@mondaydotcomorg/monday-api-mcp@latest"
      ],
      "env": {
        "monday_token": "abcd123"
      }
    }
  }
}

许可证

本项目采用 MIT 许可证，详情请参阅 LICENSE 文件。