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。

快速开始

安装

Claude桌面版

在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": "你的monday-api-key",
      "MONDAY_WORKSPACE_NAME": "你的monday-workspace-name"
    }
  }
}

使用Docker

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

使用Smithery

要通过Smithery自动为Claude桌面版安装Monday.com MCP服务器：

npx -y @smithery/cli install @sakce/mcp-server-monday --client claude

开发

构建和发布

要准备分发包：

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开始调试。