平面MCP服务器
一个模型上下文协议（MCP）服务器，它公开 飞机 Claude Code和其他兼容MCP的人工智能助手的项目管理工具。
特性
- 9工具 用于完整的票务管理
- 用户友好的标识符 -使用
SBS-123而不是UUID - 州名称解析 -通行证
"In Progress"而不是状态UUID - 多项目支持 -SBS、暴民、DE、OMNI、MWP、QUELL
- 带有有用错误的验证 -当输入无效时显示有效选项
工具
| 工具 | 说明 |
|---|---|
plane_list_issues | 列出过滤器的问题（项目、状态、优先级） |
plane_get_issue | 通过票ID获取单次发行（例如SBS-123） |
plane_create_issue | 创建新问题 |
plane_update_issue | 更新问题（状态、优先级、标题等） |
plane_delete_issue | 删除问题 |
plane_list_comments | 列出对某个问题的所有评论 |
plane_add_comment | 向问题添加评论 |
plane_list_links | 列出问题的外部链接 |
plane_add_link | 添加外部链接（例如Monday.com） |
安装
先决条件
- Node.js 18+
- npm
设置
# Clone the repository
git clone git@github.com:hieunguyenzzz/mcp-plane-ticket.git
cd mcp-plane-ticket
# Install dependencies
npm install
# Build
npm run build使用克劳德代码注册
添加到您的 ~/.claude.json:
{
"mcpServers": {
"plane": {
"command": "node",
"args": ["/path/to/mcp-plane-ticket/dist/index.js"],
"env": {
"PLANE_API_KEY": "your-plane-api-key"
}
}
}
}重新启动Claude Code以加载MCP服务器。
用法示例
列出问题
mcp__plane__plane_list_issues(project: "SBS", state: "In Progress", limit: 10)获取问题
mcp__plane__plane_get_issue(ticket_id: "SBS-123")创建问题
mcp__plane__plane_create_issue(
project: "MOB",
name: "Fix login bug",
description_html: "
Description here
",
priority: "high",
state: "Todo"
)更新问题
mcp__plane__plane_update_issue(
ticket_id: "SBS-123",
state: "Done"
)添加评论
mcp__plane__plane_add_comment(
ticket_id: "SBS-123",
comment_html: "
This is fixed now
"
)添加外部链接
mcp__plane__plane_add_link(
ticket_id: "SBS-123",
title: "Monday: Task #12345",
url: "https://monday.com/boards/123/pulses/12345"
)配置
环境变量
| 变量 | 必填 | 描述 |
|---|---|---|
PLANE_API_KEY | 是 | 您的飞机API密钥 |
支持的项目
| 项目 | 标识符 | 状态 |
|---|---|---|
| soundboxstore.com | SBS | 积压→ Todo → 进行中→ PR已提交→ 现场测试→ 完成 |
| mobelaris.com | MOB | 待办事项列表→ Todo → 进行中→ PR已提交→ 分期测试→ 现场测试→ 完成 |
| designereditions.com | DE | 待办事项→ Todo → 进行中→ PR已提交→ PR审查→ 分期测试→ 现场测试→ 完成 |
| omni.com | omni | 待办事项→ Todo → 进行中→ PR已提交→ 完成 |
| merakiwedingplanner.com | MWP | 待办事项→ Todo → 进行中→ PR已提交→ 完成 |
| queldesign.com | 排队 | 积压→ Todo → 进行中→ PR已提交→ 代码审查→ 现场测试→ 完成 |
优先级值
none-无优先级low-低优先级medium-中等优先级high-高优先级urgent-紧急优先事项
发展
项目结构
src/
├── index.ts # Main MCP server entry point
├── config/
│ └── projects.ts # Project IDs, state mappings, helpers
├── common/
│ ├── errors.ts # Custom error classes
│ └── utils.ts # HTTP request utilities
└── operations/
├── issues.ts # Issue CRUD operations
├── comments.ts # Comment operations
└── links.ts # External link operations建筑
npm run build测试
# Test tools/list
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | \
PLANE_API_KEY="your-key" node dist/index.js
# Test a tool call
echo '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"plane_list_issues","arguments":{"project":"SBS","limit":5}}}' | \
PLANE_API_KEY="your-key" node dist/index.js建筑
此MCP服务器遵循官方 模型上下文协议 规范：
- 运输：stdio（标准输入/输出）
- 软件开发工具包:
@modelcontextprotocol/sdk - 验证：Zod模式
zod-to-json-schema
关键设计决策
- 用户友好的标识符：接受
SBS-123格式化，内部解析为UUID - 州名称解析：接受
"In Progress"，映射到每个项目的状态UUID - 有用的验证错误：输入不匹配时显示有效选项
- 格式化响应：返回可读的状态名以及UUID
许可证
麻省理工学院