项目管理AI工具服务器

一个基于MCP协议的服务器,将Plane项目管理功能暴露为AI助手的工具。

  • by mael-klingler
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 mael-klingler/mcp_server_plane

使用说明

MCP服务器-平面

一 MCP(模型上下文协议) 暴露的服务器 飞机 项目管理作为人工智能助手的工具。

建于 快速API 和 FastMCP.


特性

MCP工具 说明
list_projects 列出所有Plane项目
list_issues 列出给定项目的问题
create_issue 在项目中创建新问题

服务器还公开了用于直接访问的纯REST端点:

方法 路径 描述
GET /health 健康检查
GET /projects 列出所有项目
GET /issues?project_id=<id> 列出项目的问题
POST /issues?project_id=<id>&title=<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/mcp

Claude桌面示例(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)

许可证

麻省理工学院