使用说明
平面MCP服务器+GitHub同步
用于Plane项目管理和双向GitHub的MCP（模型上下文协议）服务器↔飞机同步。ClaudePlane生态系统的一部分。
组件
1.MCP服务器(index.mjs)
为Claude Code提供16个与Plane交互的工具：
| 工具 | 说明 |
|---|---|
list_workspaces |
列出所有工作区 |
list_projects |
列出工作区中的项目 |
create_project |
创建新项目 |
get_project |
获取项目详细信息 |
list_issues |
列出问题（带过滤器） |
create_issue |
创建问题 |
update_issue |
更新问题 |
get_issue |
获取问题详细信息 |
delete_issue |
删除问题 |
add_comment |
对一个问题的评论 |
list_states |
列出工作流状态 |
list_labels |
列出标签 |
create_label |
创建标签 |
list_cycles |
列出周期（冲刺） |
create_cycle |
创建循环 |
list_modules |
列出模块 |
list_members |
列出工作区成员 |
2.GitHub Webhook同步(github-plane-webhook.mjs)
监听GitHub webhooks并将事件镜像到Plane：
- 已打开的问题 → 创建相应的平面问题
- PR已打开/准备就绪 → 创建跟踪PR的平面问题
- 推送事件 → 日志提交（可扩展以链接到问题）
设置
环境变量
export PLANE_API_URL=https://plane.oogley.net
export PLANE_API_TOKEN=<your-plane-api-token>
export WORKSPACE_SLUG=<your-workspace>
export WEBHOOK_PORT=9600 # For webhook service
export WEBHOOK_SECRET=<secret> # GitHub webhook secret
运行MCP服务器
# Via Claude Code MCP config
node /home/ubuntu/plane-mcp-server/index.mjs
# Or add to MCPJungle
运行Webhook同步
node /home/ubuntu/plane-mcp-server/github-plane-webhook.mjs
与ClaudePlane集成
此服务器旨在与 ClaudePlane，一架飞机的叉子，上面有：
- Claude Max OAuth集成（不需要API密钥）
- 自定义LLM端点支持（vLLM、SGLang、Ollama）
- 更新的克劳德车型列表（4.5/4.6系列）
- GitHub仓库同步管理命令
许可证
麻省理工学院