MCP Server Monday Qi

🚀 Monday.com MCP 服务器

适用于 monday.com 的 MCP 服务器，让 MCP 客户端能够与 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"
        ]
    }
}

使用 Smithery

通过 Smithery 自动安装适用于 Claude Desktop 的 Monday.com MCP 服务器：

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

✨ 主要特性

工具

该服务器实现了以下实用工具，方便用户在 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-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. 按照 此处 的说明创建并保存一个个人 API 令牌。
2. 从 monday.com 工作区的 URL 获取工作区名称。例如，如果 URL 是 https://myworkspace.monday.com/，则工作区名称为 myworkspace。

🔧 技术细节

构建和发布

要准备分发包，可按以下步骤操作：

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

uv sync

2. 构建包发行版：

uv build

这将在 dist/ 目录中创建源代码和轮分布。 3. 发布到 PyPI：

uv publish

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

• 令牌：--token
• 用户名：--username

调试

使用 Inspector 进行调试：

uv run mcp-server-monday -- inspector

打开控制台查看输出，复制并粘贴显示的 URL 到浏览器进行调试。