makeplane/plane-mcp-server

Plane MCP Server – 概述

Plane MCP Server 是一个小型 Python 服务，允许 AI 代理通过 Model Context Protocol (MCP) 与 Plane 项目管理平台通信。它将 LLM 驱动的助手能够理解的一般 MCP 调用转换为对 Plane REST API 的具体调用（使用官方 plane-sdk）。

对 AI 代理的重要性

工具驱动代理 – 现代 LLM 代理（Claude、ChatGPT 等）使用工具在模型之外执行操作。此服务器公开了 30 多个“工具”，每个工具代表一个 Plane 资源（项目、工作项、周期、发布、客户等）和一组操作（创建、列表、归档等）。
自文档化 – 每个工具在运行时通告其操作和所需参数，因此代理无需硬编码模式即可发现其能做什么。
多种传输方式 – 服务器可以作为本地子进程（stdio）或 HTTP 端点（带 OAuth 或 API 密钥认证）运行。这符合当前 MCP 感知客户端的构建方式。

核心功能（如 README 中所述）

功能	详情
30 个工具	每个 Plane 资源一个，覆盖 207 个不同的操作。
传输选项	• `stdio` – 作为 MCP 客户端的子进程运行。 • 带 OAuth 的 HTTP – 托管端点 `https://mcp.plane.so/http/mcp`。 • 带个人访问令牌的 HTTP – `https://mcp.plane.so/http/api-key/mcp`。 • SSE – 已弃用，但为向后兼容而保留。
认证	• API 密钥（`PLANE_API_KEY`）用于 stdio。 • OAuth 流程由托管 HTTP 传输自动处理。 • 不记名令牌（`Authorization: Bearer <PAT>`）用于 API 密钥 HTTP 传输。
查询语言	支持 Plane 的 PQL，以便在列出或计算工作项时进行强大过滤。
兼容层	较旧的按操作工具名称（177 个中的 169 个）仍然可解析，因此现有提示或脚本继续工作。
可配置代理	尊重 `HTTP_PROXY`、`HTTPS_PROXY`、`NO_PROXY` 用于附件上传 URL。
日志记录	结构化 JSON 日志；可选包含用户信息和负载。
开发友好性	离线测试套件、使用 `ruff` 进行代码检查、清晰的贡献指南。

典型使用流程

获取 Plane API 令牌（或依赖 OAuth）。
配置 MCP 客户端，使用启动 plane-mcp-server 的命令（例如 uvx plane-mcp-server stdio）。
客户端发送类似 workitem(action="list", project_id=…, pql='state__group = "started"') 的 MCP 请求。
服务器将其转换为对 plane-sdk 的调用，返回结果，并记录调用。

谁会使用？

LLM 驱动的助手 – 需要读取或修改 Plane 工作区（例如“项目经理机器人”）。
IDE 扩展（VS Code、Cursor、Claude.ai 连接器）– 将 Plane 操作暴露给基于聊天的流程。
自定义自动化 – 开发人员希望使用稳定的 MCP 端点而不是编写原始 Plane SDK 代码。

许可证与社区

该项目采用 MIT 许可证，欢迎拉取请求，并提供可离线运行的完整测试套件。它取代了旧的 Node.js 实现，将功能整合到 Python 包中。

以上所有信息均直接来自仓库的 README；没有添加外部假设。