Plane MCP Server

平面MCP服务器

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

特性

• 列出Plane工作区中的所有项目
• 获取特定项目的详细信息
• 使用可自定义属性创建新问题
• 列出并筛选项目中的问题
• 获取有关特定问题的详细信息
• 用新信息更新现有问题

先决条件

• Node.js 22.x或更高版本
• Plane.so API密钥
• Plane.so工作空间

安装

选项1：使用Smithery

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

# Install to Claude for Desktop
npx -y @smithery/cli install @kelvin6365/plane-mcp-server --client claude

此命令将自动设置Plane MCP服务器，以便与Claude一起使用。安装后，您需要通过Claude设置使用Plane API密钥和工作空间段塞来配置服务器。

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

使用Cursor安装的示例：

npx -y @smithery/cli install @kelvin6365/plane-mcp-server --client cursor

选项2：手动设置

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

1. 克隆此存储库：

git clone https://github.com/kelvin6365/plane-mcp-server.git
cd plane-mcp-server

1. 安装依赖项：

npm install

1. 构建服务器：

npm run build

使用Claude for Desktop

注： 如果您使用了上述选项1（Smithery），则可以跳过本节。Smithery会自动为您配置MCP服务器。

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

- macOS： ~/Library/Application Support/Claude/claude_desktop_config.json - 窗户： %APPDATA%\Claude\claude_desktop_config.json

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

{
  "mcpServers": {
    "plane": {
      "command": "node",
      "args": ["path/to/plane-mcp-server/build/index.js"],
      "env": {
        "PLANE_API_KEY": "your_plane_api_key_here",
        "PLANE_WORKSPACE_SLUG": "your_workspace_slug_here",
        "PLANE_HOST": "optional"
      }
    }
  }
}

1. 重新启动桌面版的Claude

可用工具

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

列出项目

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

参数：无

例子：

{}

获取项目

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

参数：

• project_id：要检索的项目的ID

例子：

{
  "project_id": "01abc123-4567-89de-0123-456789abcdef"
}

创建问题

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

参数：

• project_id：应创建问题的项目的ID
• name：问题的标题
• description_html：问题的HTML描述（平面API要求）
• priority （可选）：问题的优先级（“紧急”、“高”、“中”、“低”、“无”）
• state_id （可选）：此问题的状态ID
• assignees （可选）：要分配给此问题的用户ID数组

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

例子：

{
  "project_id": "01abc123-4567-89de-0123-456789abcdef",
  "name": "Implement new feature",
  "description_html": "
We need to implement the new reporting feature
",
  "priority": "high",
  "assignees": ["user-id-1", "user-id-2"]
}

列出问题

使用可选筛选列出指定项目中的问题。

参数：

• project_id：从中获取问题的项目ID
• state_id （可选）：按状态ID筛选
• priority （可选）：按优先级筛选
• assignee_id （可选）：按受让人ID筛选
• limit （可选）：要返回的最大问题数（默认值：50）

例子：

{
  "project_id": "01abc123-4567-89de-0123-456789abcdef",
  "priority": "high",
  "limit": 10
}

得到问题

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

参数：

• project_id：包含问题的项目的ID
• issue_id：要检索的问题的ID

例子：

{
  "project_id": "01abc123-4567-89de-0123-456789abcdef",
  "issue_id": "01def456-7890-12gh-3456-789ijklmnopq"
}

更新问题

更新项目中的现有问题。

参数：

• project_id：包含问题的项目的ID
• issue_id：要更新的问题的ID
• name （可选）：更新了问题的标题
• description_html （可选）：问题的HTML描述（API飞机要求）
• priority （可选）：更新了问题的优先级
• state_id （可选）：更新了问题的状态ID
• assignees （可选）：更新了分配给此问题的用户ID数组

注： 这 assignees 参数必须是用户ID字符串数组，遵循与创建问题工具相同的格式准则。

例子：

{
  "project_id": "01abc123-4567-89de-0123-456789abcdef",
  "issue_id": "01def456-7890-12gh-3456-789ijklmnopq",
  "priority": "urgent",
  "description_html": "
Updated description with more details
"
}

发展

1. 安装开发依赖项：

npm install --save-dev typescript @types/node

1. 在开发模式下启动服务器：

npm run dev

测试

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

npx @modelcontextprotocol/inspector node dist/index.js

例子

以下是一些在设置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许可证获得许可-有关详细信息，请参阅许可证文件。

支持

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

1. 查看GitHub问题部分
2. 请参阅MCP文件 模型上下文协议.io
3. 以详细的复制步骤打开新一期

明星历史