Plane MCP 服务器

一个用于 Plane 集成的模型上下文协议 (MCP) 服务器。该服务器提供工具和资源，以便通过 AI 智能体与 Plane 进行交互。

功能特性

• 🔧 Plane 集成：与 Plane API 和服务进行交互

• 🔌 多种传输方式：支持 stdio、SSE 和可流式传输的 HTTP 传输

• 🌐 远程与本地：既可本地运行，也可作为远程服务运行

• 🛠️ 可扩展：易于添加新的工具和资源

Related MCP server: claude-plane

使用方法

该服务器支持三种传输方式。我们建议使用 uvx，因为它不需要安装。

1. Stdio 传输（用于本地使用）

MCP 客户端配置（使用 uvx - 推荐）：

{
  "mcpServers": {
    "plane": {
      "command": "uvx",
      "args": ["plane-mcp-server", "stdio"],
      "env": {
        "PLANE_API_KEY": "<your-api-key>",
        "PLANE_WORKSPACE_SLUG": "<your-workspace-slug>",
        "PLANE_BASE_URL": "https://api.plane.so"
      }
    }
  }
}

2. 使用 OAuth 的远程 HTTP 传输

使用 OAuth 身份验证连接到托管的 Plane MCP 服务器。

URL：https://mcp.plane.so/http/mcp

MCP 客户端配置（适用于 Claude Desktop 等没有原生远程 MCP 支持的工具）：

{
  "mcpServers": {
    "plane": {
      "command": "npx",
      "args": ["mcp-remote@latest", "https://mcp.plane.so/http/mcp"]
    }
  }
}

注意：连接到远程服务器时，OAuth 身份验证将自动处理。

3. 使用 PAT 令牌的远程 HTTP 传输

使用个人访问令牌 (PAT) 连接到托管的 Plane MCP 服务器。

URL：https://mcp.plane.so/api-key/mcp

请求头：

• Authorization: Bearer <PAT_TOKEN>

• X-Workspace-slug: <SLUG>

MCP 客户端配置（适用于 Claude Desktop 等没有原生远程 MCP 支持的工具）：

{
  "mcpServers": {
    "plane": {
      "command": "npx",
      "args": ["mcp-remote@latest", "https://mcp.plane.so/http/api-key/mcp"],
      "headers": {
        "Authorization": "Bearer <PAT_TOKEN>",
        "X-Workspace-slug": "<SLUG>"
      }
    }
  }
}

4. SSE 传输（旧版）

⚠️ 旧版传输：SSE (Server-Sent Events) 传输仅为向后兼容而保留。新实现应使用 HTTP 传输（第 2 或第 3 节）。

通过服务器发送事件 (SSE) 使用 OAuth 身份验证连接到托管的 Plane MCP 服务器。

URL：https://mcp.plane.so/sse

MCP 客户端配置（适用于支持 SSE 传输的工具）：

{
  "mcpServers": {
    "plane": {
      "command": "npx",
      "args": ["mcp-remote@latest", "https://mcp.plane.so/sse"]
    }
  }
}

注意：连接到远程服务器时，OAuth 身份验证将自动处理。此传输方式已被弃用，建议改用 HTTP 传输。

配置

身份验证

服务器需要通过环境变量进行身份验证：

• PLANE_BASE_URL：Plane API 的基础 URL（默认：https://api.plane.so）- 可选

• PLANE_API_KEY：用于身份验证的 API 密钥（stdio 传输必需）

• PLANE_WORKSPACE_SLUG：工作区标识符（stdio 传输必需）

• PLANE_ACCESS_TOKEN：用于身份验证的访问令牌（API 密钥的替代方案）

示例（用于 stdio 传输）：

export PLANE_BASE_URL="https://api.plane.so"
export PLANE_API_KEY="your-api-key"
export PLANE_WORKSPACE_SLUG="your-workspace-slug"

注意：对于远程 HTTP 传输（OAuth 或 PAT），身份验证通过连接方法（OAuth 流程或 PAT 请求头）处理，不需要这些环境变量。

可用工具

该服务器提供了用于与 Plane 交互的全面工具。所有工具均使用 Plane SDK 中的 Pydantic 模型，以确保类型安全和验证。

项目 (Projects)

工作项 (Work Items)

周期 (Cycles)

模块 (Modules)

倡议 (Initiatives)

接入工作项 (Intake Work Items)

工作项属性 (Work Item Properties)

用户 (Users)

工具总数：8 个类别中共 55+ 个工具

开发

运行测试

pytest

代码格式化

black plane_mcp/
ruff check plane_mcp/

许可证

MIT 许可证 - 详情请参阅 LICENSE。

贡献

欢迎贡献！请随时提交 Pull Request。

弃用通知

⚠️ 基于 Node.js 的 plane-mcp-server 已弃用，不再维护。

此仓库代表了基于 Python+FastMCP 的新版 Plane MCP 服务器实现。如果您之前使用的是 Node.js 版本，请迁移到此 Python 版本以获得持续的支持和更新。

新实现提供：

• 使用 Pydantic 模型实现更好的类型安全

• 使用 FastMCP 提高性能

• 增强的工具覆盖范围

• 积极的维护和开发

如需迁移帮助，请参考此 README 中的配置示例或提交 issue 以获取支持。

旧版 Node.js 配置（已弃用）：

如果您之前使用的是旧版基于 Node.js 的 @makeplane/plane-mcp-server，您的配置如下所示：

{
  "mcpServers": {
    "plane": {
      "command": "npx",
      "args": [
        "-y",
        "@makeplane/plane-mcp-server"
      ],
      "env": {
        "PLANE_API_KEY": "<YOUR_API_KEY>",
        "PLANE_API_HOST_URL": "<HOST_URL_FOR_SELF_HOSTED>",
        "PLANE_WORKSPACE_SLUG": "<YOUR_WORKSPACE_SLUG>"
      }
    }
  }
}

请迁移到上述“使用方法”部分中显示的基于 Python 的新配置。