Plane MCP Server

Official

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

平面 MCP 服务器

Plane MCP 服务器是一个模型上下文协议 (MCP) 服务器,可与 Plane API 无缝集成,为开发和 AI 接口提供项目、工作项和自动化功能。

用例

  • 创建、更新项目和工作项
  • 分配人员、属性并撰写评论以推进工作
  • 在美国境内移动并观察各种工作项目
  • 为工作项添加标签
  • 从 Plane 内的项目和成员中提取和分析数据
  • 构建与 Plane 生态系统交互的 AI 驱动工具和应用程序

配置参数

  1. PLANE_API_KEY - 用户的 API 令牌。可从 UI 中的/settings/api-tokens/页面获取。
  2. PLANE_WORKSPACE_SLUG - 您的 Plane 实例的工作区 slug。
  3. PLANE_API_HOST_URL (可选)- Plane API 服务器的主机 URL。默认为https://api.plane.so/

工具

用户

  • get_user获取当前用户的信息
    • 无需参数

项目

  • get_projects - 获取当前用户的所有项目
    • 无需参数
  • create_project创建新项目
    • name :项目名称(字符串,必需)

问题类型

  • list_issue_types - 获取特定项目的所有问题类型
    • project_id :项目的 UUID(字符串,必需)
  • get_issue_type - 获取特定问题类型的详细信息
    • project_id :项目的 UUID(字符串,必需)
    • type_id :问题类型的 UUID(字符串,必需)
  • create_issue_type - 在项目中创建新的问题类型
    • project_id :项目的 UUID(字符串,必需)
    • issue_type_data :对象包含:
      • name :问题类型的名称(字符串,必需)
      • description :问题类型的描述(字符串,必需)
  • update_issue_type - 更新现有问题类型
    • project_id :项目的 UUID(字符串,必需)
    • type_id :问题类型的 UUID(字符串,必需)
    • issue_type_data :问题类型要更新的字段(对象)
  • delete_issue_type - 删除问题类型
    • project_id :项目的 UUID(字符串,必需)
    • type_id :问题类型的 UUID(字符串,必需)

  • list_states - 获取特定项目的所有状态
    • project_id :项目的 UUID(字符串,必需)
  • get_state获取特定状态的详细信息
    • project_id :项目的 UUID(字符串,必需)
    • state_id :状态的 UUID(字符串,必需)
  • create_state - 在项目中创建新状态
    • project_id :项目的 UUID(字符串,必需)
    • state_data :对象包含:
      • name :州名(字符串,必需)
      • color :状态的颜色代码(字符串,必需)
  • update_state - 更新现有状态
    • project_id :项目的 UUID(字符串,必需)
    • state_id :状态的 UUID(字符串,必需)
    • state_data :状态上要更新的字段(对象)
  • delete_state - 删除状态
    • project_id :项目的 UUID(字符串,必需)
    • state_id :状态的 UUID(字符串,必需)

标签

  • list_labels - 获取特定项目的所有标签
    • project_id :项目的 UUID(字符串,必需)
  • get_label - 获取特定标签的详细信息
    • project_id :项目的 UUID(字符串,必需)
    • label_id :标签的 UUID(字符串,必需)
  • create_label - 在项目中创建新标签
    • project_id :项目的 UUID(字符串,必需)
    • label_data :包含以下内容的对象:
      • name :标签名称(字符串,必需)
      • color :标签的颜色代码(字符串,必需)
  • update_label - 更新现有标签
    • project_id :项目的 UUID(字符串,必需)
    • label_id :标签的 UUID(字符串,必需)
    • label_data :标签上要更新的字段(对象)
  • delete_label删除标签
    • project_id :项目的 UUID(字符串,必需)
    • label_id :标签的 UUID(字符串,必需)

问题

  • get_issue_using_readable_identifier - 使用可读标识符获取问题详细信息(例如 PROJ-123)
    • project_identifier :项目标识符(例如“PROJ”)(字符串,必需)
    • issue_identifier :问题编号(例如“123”)(字符串,必需)
  • get_issue_comments - 获取特定问题的所有评论
    • project_id :项目的 UUID(字符串,必需)
    • issue_id :问题的 UUID(字符串,必需)
  • add_issue_comment - 向问题添加评论
    • project_id :项目的 UUID(字符串,必需)
    • issue_id :问题的 UUID(字符串,必需)
    • comment_html :评论的 HTML 内容(字符串,必需)
  • create_issue创建新问题
    • project_id :项目的 UUID(字符串,必需)
    • issue_data :对象包含:
      • name :问题标题(字符串,必需)
      • description_html :问题的 HTML 描述(字符串,必需)
  • update_issue - 更新现有问题
    • project_id :项目的 UUID(字符串,必需)
    • issue_id :问题的 UUID(字符串,必需)
    • issue_data :问题上要更新的字段(对象)

模块

  • list_modules - 获取特定项目的所有模块
    • project_id :项目的 UUID(字符串,必需)
  • get_module获取特定模块的详细信息
    • project_id :项目的 UUID(字符串,必需)
    • module_id :模块的 UUID(字符串,必需)
  • create_module在项目中创建新模块
    • project_id :项目的 UUID(字符串,必需)
    • module_data :对象包含:
      • name :模块名称(字符串,必需)
  • update_module更新现有模块
    • project_id :项目的 UUID(字符串,必需)
    • module_id :模块的 UUID(字符串,必需)
    • module_data :模块上要更新的字段(对象)
  • delete_module删除模块
    • project_id :项目的 UUID(字符串,必需)
    • module_id :模块的 UUID(字符串,必需)

模块问题

  • list_module_issues - 获取特定模块的所有问题
    • project_id :项目的 UUID(字符串,必需)
    • module_id :模块的 UUID(字符串,必需)
  • add_module_issues - 向模块添加问题
    • project_id :项目的 UUID(字符串,必需)
    • module_id :模块的 UUID(字符串,必需)
    • issues :要添加的问题 UUID 数组(string[],必需)
  • delete_module_issue - 从模块中删除问题
    • project_id :项目的 UUID(字符串,必需)
    • module_id :模块的 UUID(字符串,必需)
    • issue_id :要删除的问题的 UUID(字符串,必需)

周期

  • list_cycles - 获取特定项目的所有周期
    • project_id :项目的 UUID(字符串,必需)
  • get_cycle获取特定周期的详细信息
    • project_id :项目的 UUID(字符串,必需)
    • cycle_id :循环的 UUID(字符串,必需)
  • create_cycle - 在项目中创建一个新的循环
    • project_id :项目的 UUID(字符串,必需)
    • cycle_data :对象包含:
      • name :循环的名称(字符串,必需)
      • start_date :开始日期(YYYY-MM-DD)(字符串,必需)
      • end_date :结束日期(YYYY-MM-DD)(字符串,必需)
  • update_cycle - 更新现有循环
    • project_id :项目的 UUID(字符串,必需)
    • cycle_id :循环的 UUID(字符串,必需)
    • cycle_data :循环中要更新的字段(对象)
  • delete_cycle - 删除一个循环
    • project_id :项目的 UUID(字符串,必需)
    • cycle_id :循环的 UUID(字符串,必需)

周期问题

  • list_cycle_issues - 获取特定周期的所有问题
    • project_id :项目的 UUID(字符串,必需)
    • cycle_id :循环的 UUID(字符串,必需)
  • add_cycle_issues - 将问题添加到周期
    • project_id :项目的 UUID(字符串,必需)
    • cycle_id :循环的 UUID(字符串,必需)
    • issues :要添加的问题 UUID 数组(string[],必需)
  • delete_cycle_issue - 从周期中删除问题
    • project_id :项目的 UUID(字符串,必需)
    • cycle_id :循环的 UUID(字符串,必需)
    • issue_id :要删除的问题的 UUID(字符串,必需)

工作日志

  • get_issue_worklogs - 获取特定问题的所有工作日志
    • project_id :项目的 UUID(字符串,必需)
    • issue_id :问题的 UUID(字符串,必需)
  • get_total_worklogs - 获取项目的总记录时间
    • project_id :项目的 UUID(字符串,必需)
  • create_worklog - 为问题创建新的工作日志
    • project_id :项目的 UUID(字符串,必需)
    • issue_id :问题的 UUID(字符串,必需)
    • worklog_data :对象包含:
      • description :已完成工作的描述(字符串,必需)
      • duration :持续时间(分钟)(整数,必需)
  • update_worklog - 更新现有的工作日志
    • project_id :项目的 UUID(字符串,必需)
    • issue_id :问题的 UUID(字符串,必需)
    • worklog_id :工作日志的 UUID(字符串,必需)
    • worklog_data :工作日志中要更新的字段(对象)
  • delete_worklog - 删除工作日志
    • project_id :项目的 UUID(字符串,必需)
    • issue_id :问题的 UUID(字符串,必需)
    • worklog_id :工作日志的 UUID(字符串,必需)

用法

克劳德桌面

通过编辑claude_desktop_config.json将 Plane 添加到Claude Desktop

{ "mcpServers": { "plane": { "command": "npx", "args": [ "-y", "@makeplane/plane-mcp-server" ], "env": { "PLANE_API_KEY": "<YOUR_API_KEY>", "PLANE_API_HOST_URL": "<HOST_URL_FOR_SELF_HOSTED", "PLANE_WORKSPACE_SLUG": "<YOUR_WORKSPACE_SLUG>" } } } }

VSCode

通过编辑.vscode.json/mcp.json将 Plane 添加到VSCode

{ "servers": { "plane": { "command": "npx", "args": [ "-y", "@makeplane/plane-mcp-server" ], "env": { "PLANE_API_KEY": "<YOUR_API_KEY>", "PLANE_API_HOST_URL": "<HOST_URL_FOR_SELF_HOSTED", "PLANE_WORKSPACE_SLUG": "<YOUR_WORKSPACE_SLUG>" } } } }

执照

该项目根据 MIT 开源许可条款进行授权。

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

模型上下文协议服务器使 AI 接口能够与 Plane 的项目管理系统无缝交互,从而允许通过标准化 API 管理项目、问题、状态和其他工作项。

  1. Use Cases
    1. Configuration Parameters
      1. Tools
        1. Users
        2. Projects
        3. Issue Types
        4. States
        5. Labels
        6. Issues
        7. Modules
        8. Module Issues
        9. Cycles
        10. Cycle Issues
        11. Work Logs
      2. Usage
        1. Claude Desktop
        2. VSCode
      3. License
        ID: y5g9z3v76n