JinDaGe - mcp-server-monday MCP Details

article

README

🚀 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 可自动将 Monday.com MCP 服务器安装到 Claude Desktop：

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

✨ 主要特性

组件 - 工具

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

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：用于向现有文档添加块。

📚 详细文档

设置

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

开发

构建和发布

准备分发包的步骤如下：

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

uv sync

构建包发行版：

uv build

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

uv publish

注意：你需要通过环境变量或命令行参数设置 PyPI 资格凭证：

令牌：--token 或 MONDAY_API_KEY
工作区名称：--workspace-name 或 MONDAY_WORKSPACE_NAME

调试

使用 Inspector 调试：

uv run mcp-server-monday

调试服务器运行时，可以通过以下 URL 访问 Inspector 的 Web 界面： http://localhost:3000

mcp-server-monday