Monday.com MCP 服务器

Monday.com 的 MCP 服务器使 MCP 客户端能够与 Monday.com 的看板、项目、更新和文档进行交互。

组件

工具

服务器实现了以下工具：

• monday-create-item：在 Monday.com 看板中创建一个新项目或子项目
• monday-get-board-groups：从指定的 Monday.com 看板中检索所有分组
• monday-create-update：在 Monday.com 项目上创建评论/更新
• monday-list-boards：列出所有可用的 Monday.com 看板
• monday-list-items-in-groups：列出 Monday.com 看板中指定分组的所有项目
• monday-list-subitems-in-items：列出给定 Monday.com 项目的所有子项目
• monday-create-board：创建一个新的 Monday.com 看板
• monday-create-board-group：在 Monday.com 看板中创建一个新分组
• monday-move-item-to-group：将 Monday.com 项目移动到不同的分组
• monday-delete-item：删除 Monday.com 项目
• monday-archive-item：归档 Monday.com 项目
• monday-get-item-updates：检索特定项目的更新/评论
• monday-get-docs：列出 Monday.com 中的文档，可选择按文件夹过滤
• monday-get-doc-content：检索特定文档的内容
• monday-create-doc：在 Monday.com 中创建新文档
• monday-add-doc-block：向现有文档添加块

设置

1. 按照此处的说明，在 Monday.com 中创建并保存个人 API 令牌。
2. 从 Monday.com 工作区的 URL 中获取工作区名称。例如，如果 URL 是 https://myworkspace.monday.com/，则工作区名称为 myworkspace。

快速开始

使用 Rube

1. 访问 Rube.app
2. 在您首选的客户端（包括 Cursor、Claude、VS Code、Windsurf 等）中安装 Rube。
3. 完成 Rube 的身份验证
4. 您现在可以在 Monday.com 上执行操作，如创建项目、发布更新、移动项目等

安装

Claude Desktop

在 MacOS 上：~/Library/Application\ Support/Claude/claude_desktop_config.json

在 Windows 上：%APPDATA%/Claude/claude_desktop_config.json

使用 uvx

"mcpServers": {
  "monday": {
    "command": "uvx",
    "args": [
      "mcp-server-monday"
    ],
    "env": {
      "MONDAY_API_KEY": "your-monday-api-key",
      "MONDAY_WORKSPACE_NAME": "your-monday-workspace-name"
    }
  }
}

使用 Docker

"mcpServers": {
  "monday-docker": {
    "command": "docker",
    "args": [
      "run", 
      "--rm", 
      "-i", 
      "-e",
      "MONDAY_API_KEY=your-monday-api-key",
      "-e",
      "MONDAY_WORKSPACE_NAME=your-monday-workspace-name",
      "sakce/mcp-server-monday"
    ]
  }
}

开发

构建与发布

为分发准备包：

1. 同步依赖项并更新锁文件：

uv sync

2. 构建包分发：

uv build

这将在 dist/ 目录中创建源代码和 wheel 分发。

3. 发布到 PyPI：

uv publish

注意：您需要通过环境变量或命令行标志设置 PyPI 凭据：

• 令牌：--token 或 UV_PUBLISH_TOKEN
• 或用户名/密码：--username/UV_PUBLISH_USERNAME 和 --password/UV_PUBLISH_PASSWORD

调试

由于 MCP 服务器通过 stdio 运行，调试可能具有挑战性。为了获得最佳的调试体验，我们强烈建议使用 MCP 检查器。

您可以通过 npm 启动 MCP 检查器，使用以下命令：

npx @modelcontextprotocol/inspector uv run mcp-server-monday

启动后，检查器将显示一个 URL，您可以在浏览器中访问该 URL 以开始调试。