Claude Plane

ClaudePlane

MCP服务器和自动化监视器 飞机 项目管理。

特征：

• MCP服务器为Claude与Plane交互提供40多种工具
• 当问题被标记或更新时，自动触发Claude的监视器
• 自托管飞机支持
• MCP和监视器的单个配置文件

安装

git clone https://github.com/FishyF1sh/claude-plane.git
cd claude-plane
npm install
npm run build

快速开始

1.创建配置文件

在项目目录中，创建 plane.config.json:

{
  "plane": {
    "baseUrl": "https://your-plane-instance.com",
    "apiKey": "plane_api_your-api-key",
    "workspace": "your-workspace",
    "project": "your-project"
  },
  "watch": {
    "pollIntervalSeconds": 30,
    "triggerLabel": "claude",
    "triggers": {
      "onLabelAdded": true,
      "onReopened": true,
      "onNewComment": true
    }
  },
  "claude": {
    "prompt": "/fix-issue {identifiers}"
  }
}

2.配置克劳德代码

添加到 ~/.claude.json:

{
  "projects": {
    "/path/to/your/project": {
      "mcpServers": {
        "plane": {
          "type": "stdio",
          "command": "node",
          "args": ["/path/to/claude-plane/dist/index.js"],
          "env": {
            "PLANE_CONFIG": "/path/to/your/project/plane.config.json"
          }
        }
      }
    }
  }
}

3.控制监视器（可选）

监视器可以通过两种方式控制：

通过MCP工具（推荐）： 让Claude使用内置工具启动/停止监视器：

• plane_watcher_start -开始监控标记的问题
• plane_watcher_stop -停止观察者
• plane_watcher_status -检查观察者状态和日志

通过命令行：

cd /path/to/your/project
node /path/to/claude-plane/dist/watcher.js

就是这样！Claude现在可以与Plane交互，观察者将在标记的问题上自动触发Claude。

______________________________________________________________________

配置参考

plane.config.json

{
  "plane": {
    "baseUrl": "https://your-plane-instance.com",
    "apiKey": "plane_api_your-api-key",
    "workspace": "your-workspace",
    "project": "your-project"
  },
  "watch": {
    "pollIntervalSeconds": 30,
    "triggerLabel": "claude",
    "triggers": {
      "onLabelAdded": true,
      "onReopened": true,
      "onNewComment": true
    }
  },
  "claude": {
    "prompt": "/fix-issue {identifiers}"
  }
}

触发条件

提示占位符

______________________________________________________________________

可用的MCP工具

项目： plane_list_projects, plane_get_project, plane_create_project, plane_update_project, plane_delete_project

工作项目： plane_list_work_items, plane_get_work_item, plane_create_work_item, plane_update_work_item, plane_delete_work_item

循环： plane_list_cycles, plane_get_cycle, plane_create_cycle, plane_update_cycle, plane_delete_cycle, plane_add_work_items_to_cycle, plane_remove_work_item_from_cycle

模块： plane_list_modules, plane_get_module, plane_create_module, plane_update_module, plane_delete_module, plane_add_work_items_to_module, plane_remove_work_item_from_module

国家： plane_list_states, plane_create_state, plane_update_state, plane_delete_state

标签： plane_list_labels, plane_create_label, plane_update_label, plane_delete_label

评论： plane_list_comments, plane_create_comment, plane_update_comment, plane_delete_comment

链接： plane_list_links, plane_create_link, plane_delete_link

活动： plane_list_activities

成员： plane_list_workspace_members, plane_list_project_members

附件： plane_list_attachments, plane_upload_attachment, plane_delete_attachment

用户： plane_get_current_user

观察者： plane_watcher_start, plane_watcher_stop, plane_watcher_status

______________________________________________________________________

自定义Claude命令

示例命令包含在 examples/commands/。要安装它们，请执行以下操作：

cp examples/commands/*.md ~/.claude/commands/

可用命令

修复问题 -通过实施修复、提交更改和更新问题状态来处理平面问题。

用途：

/fix-issue PROJ-123
/fix-issue PROJ-123 PROJ-124

您可以自定义这些命令，也可以基于它们创建自己的命令。

______________________________________________________________________

向后兼容性

MCP服务器还支持环境变量，而不是配置文件：

{
  "env": {
    "PLANE_API_KEY": "plane_api_...",
    "PLANE_BASE_URL": "https://...",
    "PLANE_WORKSPACE_SLUG": "your-workspace"
  }
}

______________________________________________________________________

发展

npm run build        # Build
npm start            # Run MCP server
npm run watch        # Run watcher
npm run dev          # Dev mode (MCP)
npm run dev:watch    # Dev mode (watcher)

许可证

麻省理工学院