Plane MCP Server

Plane MCP Server

site icon
2025.05.09 0
TypeScript项目管理工作流自动化交流协作开发效率
Plane MCP Server 是一个 Model Context Protocol (MCP) 服务器,提供与 Plane API 的无缝集成,支持项目、工作项和自动化功能,适用于开发者和 AI 接口。
View on GitHub

Overview

基本能力

产品定位

Plane MCP Server 是一个用于与 Plane 平台集成的中间件,提供项目管理和工作项操作的能力,支持开发者和 AI 工具高效协作。

核心功能

  • 项目管理:创建、更新项目和工作项
  • 工作项管理:分配人员、属性、添加评论、移动和观察工作项状态
  • 标签管理:为工作项添加标签
  • 数据提取与分析:从 Plane 平台提取和分析项目及成员数据
  • AI 工具支持:构建与 Plane 生态系统交互的 AI 工具和应用

适用场景

  • 团队协作项目管理
  • 自动化工作流构建
  • AI 驱动的工具开发

工具列表

  1. 用户管理
  2. get_user:获取当前用户信息

  3. 项目管理

  4. get_projects:获取所有项目
  5. create_project:创建新项目

  6. 问题类型管理

  7. list_issue_types:列出项目的问题类型
  8. create_issue_type:创建新问题类型

  9. 状态管理

  10. list_states:列出项目状态
  11. create_state:创建新状态

  12. 标签管理

  13. list_labels:列出项目标签
  14. create_label:创建新标签

  15. 问题管理

  16. get_issue_using_readable_identifier:通过标识符获取问题详情
  17. create_issue:创建新问题

  18. 模块管理

  19. list_modules:列出项目模块
  20. create_module:创建新模块

  21. 周期管理

  22. list_cycles:列出项目周期
  23. create_cycle:创建新周期

  24. 工作日志管理

  25. get_issue_worklogs:获取问题的工作日志
  26. create_worklog:创建工作日志

常见问题解答

  • 如何获取 API Key:从 Plane 平台的 /settings/api-tokens/ 页面获取
  • 如何配置工作区:设置 PLANE_WORKSPACE_SLUG 环境变量

使用教程

使用依赖

  • 需要 Node.js 环境
  • 安装命令:npm install -g npx

安装教程

  1. 通过 npm 安装: bash npx -y @makeplane/plane-mcp-server
  2. 配置环境变量:
  3. PLANE_API_KEY:API Key
  4. PLANE_WORKSPACE_SLUG:工作区标识
  5. PLANE_API_HOST_URL:API 主机 URL(可选)

调试方式

  1. 检查服务是否运行: bash curl http://localhost:3000/health
  2. 测试 API 连接: bash curl -H "Authorization: Bearer $PLANE_API_KEY" "$PLANE_API_HOST_URL/api/v1/projects"

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。