平面 MCP 服务器

一个模型上下文协议 (MCP) 服务器，使 LLM 能够与Plane.so交互，从而允许他们通过 Plane 的 API 管理项目和问题。使用此服务器，像 Claude 这样的 LLM 可以直接与您的项目管理工作流交互，同时保持用户控制权和安全性。

特征

• 列出 Plane 工作区中的所有项目

• 获取有关特定项目的详细信息

• 创建具有可自定义属性的新问题

• 列出并过滤项目中的问题

• 获取有关特定问题的详细信息

• 使用新信息更新现有问题

Related MCP server: Linear MCP Server

先决条件

• Node.js 22.x 或更高版本

• Plane.so API 密钥

• Plane.so 工作区

安装

选项 1：使用 Smithery

最快的入门方式是使用 Smithery 直接安装服务器：

此命令将自动设置 Plane MCP 服务器，以便与 Claude 配合使用。安装完成后，您需要通过 Claude 设置，使用您的 Plane API 密钥和工作区 slug 配置服务器。

有效的客户端选项有：claude、cline、windsurf、roo-cline、witsy、enconvo、cursor

使用 Cursor 安装的示例：

选项 2：手动设置

如果您希望手动设置服务器，请按照以下步骤操作：

1. 克隆此存储库：

2. 安装依赖项：

3. 构建服务器：

与 Claude 桌面版一起使用

**注意：**如果您使用了上面的选项 1（Smithery），则可以跳过此部分。Smithery 会自动为您配置 MCP 服务器。

1. 打开您的 Claude for Desktop 配置文件：

   • macOS： ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows： %APPDATA%\Claude\claude_desktop_config.json

2. 添加 Plane MCP 服务器配置：

3. 重启 Claude 桌面版

可用工具

**注意：**工具名称使用连字符（例如list-projects ），而不是下划线。服务器会自动将下划线转换为连字符以保持兼容性。

列出项目

列出 Plane 工作区中的所有项目。

参数：无

例子：

获取项目

获取有关特定项目的详细信息。

参数：

• project_id ：要检索的项目的 ID

例子：

创建问题

在指定项目中创建新问题。

参数：

• project_id ：应创建问题的项目的 ID

• name ：问题标题

• description_html ：问题的 HTML 描述（Plane API 所需）

• priority （可选）：问题的优先级（“紧急”，“高”，“中”，“低”，“无”）

• state_id （可选）：此问题的状态 ID

• assignees （可选）：分配给此问题的用户 ID 数组

注意： assignees参数必须是用户 ID 字符串数组。常见错误包括提供字典/对象而不是数组，或者意外地将整个问题数据嵌套在assignees 字段中。服务器会尝试处理这些情况，但最好使用正确的格式。

例子：

列出问题

列出指定项目的问题，并带有可选的过滤功能。

参数：

• project_id ：获取问题的项目的 ID

• state_id （可选）：按州 ID 过滤

• priority （可选）：按优先级过滤

• assignee_id （可选）：按受让人ID过滤

• limit （可选）：返回的最大问题数（默认值：50）

例子：

获取问题

获取有关特定问题的详细信息。

参数：

• project_id ：包含该问题的项目的 ID

• issue_id ：要检索的问题的 ID

例子：

更新问题

更新项目中的现有问题。

参数：

• project_id ：包含该问题的项目的 ID

• issue_id ：要更新的问题的 ID

• name （可选）：问题的更新标题

• description_html （可选）：问题的 HTML 描述（Plane API 要求）

• priority （可选）：更新问题的优先级

• state_id （可选）：问题的更新状态 ID

• assignees （可选）：更新分配给此问题的用户 ID 数组

注意： assignees参数必须是用户 ID 字符串数组，遵循与 create-issue 工具相同的格式指南。

例子：

发展

1. 安装开发依赖项：

2. 以开发模式启动服务器：

测试

您可以使用 MCP 检查器测试服务器：

示例

设置 Plane MCP 服务器后，您可以尝试与 Claude 进行以下一些示例交互：

1. “你能列出我的 Plane 工作区中的所有项目吗？”

2. “请在营销项目中创建一个名为‘更新社交媒体策略’的新高优先级问题”

3. “开发项目中所有高优先级问题是什么？”

4. “更新 QA 项目中的问题 #123，将其优先级更改为紧急”

在创建或修改任何问题之前，Claude 将使用适当的工具与 Plane 进行交互，同时征求您的批准。

安全注意事项

• API 密钥需要适当的 Plane 权限才能运行

• 所有修改数据的操作都需要用户明确批准

• 环境变量应得到妥善保护

• API 密钥永远不应提交到版本控制

贡献

1. 分叉存储库

2. 创建你的功能分支（ git checkout -b feature/amazing-feature ）

3. 提交您的更改（ git commit -m 'Add some amazing feature' ）

4. 推送到分支（ git push origin feature/amazing-feature ）

5. 打开拉取请求

执照

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。

支持

如果您遇到任何问题或有疑问：

1. 查看 GitHub 问题部分

2. 请参阅modelcontextprotocol.io上的 MCP 文档

3. 开启新问题并附上详细的复现步骤

星史