MCP服务器-平面
一 MCP（模型上下文协议） 暴露的服务器 飞机 项目管理作为人工智能助手的工具。
______________________________________________________________________
特性
| MCP工具 | 说明 |
|---|---|
list_projects | 列出所有Plane项目 |
list_issues | 列出给定项目的问题 |
create_issue | 在项目中创建新问题 |
服务器还公开了用于直接访问的纯REST端点：
| 方法 | 路径 | 描述 |
|---|---|---|
GET | /health | 健康检查 |
GET | /projects | 列出所有项目 |
GET | /issues?project_id= | 列出项目的问题 |
POST | /issues?project_id=&title= | 创建新问题 |
MCP端点安装在 /mcp.
______________________________________________________________________
需求
- Docker&Docker编写 或 Python 3.11+
- 跑步 飞机 具有API访问权限的实例
______________________________________________________________________
配置
创建一个 .env 项目根目录中的文件：
PLANE_API_URL=https://your-plane-instance.example.com
PLANE_API_KEY=your_api_key_here
PORT=8000| 变量 | 描述 | 默认值 |
|---|---|---|
PLANE_API_URL | Plane实例的基本URL | *（必填）* |
PLANE_API_KEY | 平面API密钥（承载令牌） | *（必填）* |
PORT | 服务器监听的端口 | 8000 |
您可以在下的Plane帐户设置中生成Plane API密钥 API令牌.
______________________________________________________________________
使用Docker Compose运行（推荐）
# 1. Create your .env file (see above)
cp .env.example .env # or create it manually
# 2. Build & start
docker compose up -d
# 3. Check that it's running
curl http://localhost:8000/health
# {"status":"ok"}______________________________________________________________________
本地运行（无Docker）
cd app
pip install "mcp>=1,<2" fastapi uvicorn requests
PLANE_API_URL=https://your-plane.example.com \
PLANE_API_KEY=your_key \
uvicorn main:app --host 0.0.0.0 --port 8000______________________________________________________________________
连接AI客户端
将您的MCP兼容客户端（例如Claude Desktop、Cursor、Continue）指向：
http://localhost:8000/mcpClaude桌面示例(claude_desktop_config.json)
{
"mcpServers": {
"plane": {
"url": "http://localhost:8000/mcp"
}
}
}______________________________________________________________________
项目结构
.
├── app/
│ └── main.py # FastAPI + FastMCP application
├── Dockerfile
├── docker-compose.yml
└── .env # Your local config (not committed)______________________________________________________________________
许可证
麻省理工学院