Selfhost Plane MCP Server

基本能力

产品定位

Plane MCP Server 是一个为 AI 助手设计的中间件，用于与 Plane 项目管理平台进行交互，提供项目管理的自动化能力。

核心功能

• 列出工作区、项目、周期、模块和问题
• 创建、更新和删除问题
• 为问题添加评论
• 根据多种条件过滤问题
• 获取 Plane 实体（如项目、周期等）的详细信息

适用场景

• 项目管理自动化
• AI 助手与项目管理工具的集成
• 团队协作中的任务管理

工具列表

Workspace Tools

• list-workspaces: 列出所有工作区
• get-workspace: 获取当前工作区的详细信息

Project Tools

• list-projects: 列出所有项目
• get-project: 获取特定项目的详细信息

State Tools

• get-project-states: 获取项目中所有状态

Cycle Tools

• list-cycles: 列出项目中所有周期
• get-cycle: 获取特定周期的详细信息

Module Tools

• list-modules: 列出项目中所有模块
• get-module: 获取特定模块的详细信息

Issue Tools

• list-issues: 列出项目中的问题（可过滤）
• get-issue: 获取特定问题的详细信息
• create-issue: 创建新问题
• update-issue: 更新现有问题
• delete-issue: 删除问题

Comment Tools

• list-issue-comments: 列出问题的所有评论
• add-issue-comment: 为问题添加评论

使用教程

使用依赖

1. 确保已安装 Node.js 和 npm

安装教程

1. 克隆仓库
2. 安装依赖：

   npm install

1. 创建 .env 文件，基于 .env.example 配置你的 Plane 凭证：

   PLANE_API_KEY=your_api_key
   PLANE_BASE_URL=https://plane.yourdomain.com
   PLANE_WORKSPACE_SLUG=your_workspace_slug

1. 构建 TypeScript 代码：

   npm run build

1. 运行服务器：

   npm start

调试方式

在开发模式下运行，支持自动重载：

npm run dev