C

Claude Plane桥服

@deus-h/claudeus-plane-mcp
0 Stars 15 次浏览 deus-h 更新于 2026-08-23

一座桥梁服务器，它将Claude AI与Plane项目管理平台连接起来，实现了由AI驱动的项目管理任务，包括项目创建、任务管理、团队协作和自动化工作流。

该服务暂未提供标准配置，请参考 README 手动接入

服务介绍

⚠️ 私有仓库通知 ⚠️

这是一个仅限 SimHop IT & Media AB 团队成员访问的私有仓库。虽然代码可以在 MIT 许可下查看和使用，但我们目前不接受公共贡献。欢迎您 fork 该仓库并创建自己的版本，只要它与我们的包不是完全相同或极其相似，以避免用户混淆。

🤘 Claudeus Plane MCP 🎸

"在您的飞机领域释放 AI 的力量 - 设定 MCP 卓越标准！" 🖤

License
Node
GitHub Stars
NPM Version
NPM Downloads
GitHub Discussions
GitHub Forks
smithery badge
MCP Standard
Test Coverage

🎯 我们的使命：用 AI 提升项目管理

在迅速发展的 AI 驱动的项目管理领域，我们推出了 Claudeus Plane MCP —— 一个强大的桥梁，连接了 Claude 的 AI 能力和平面的项目管理平台。我们的使命是：

  • ✅ 为 Plane 提供无缝的 AI 集成
  • ✅ 启用自动化的项目管理工作流
  • ✅ 通过 AI 辅助增强团队协作
  • ✅ 简化任务和资源管理
  • ✅ 设定新的 MCP 开发标准

为什么选择 Claudeus Plane MCP？

基于我们成功的 Claudeus WordPress MCP 基础之上，这个服务器带来了同样的水平：

  • 🎸 技术卓越：完整的 TypeScript 覆盖率和严格的类型检查
  • 🎸 质量保证：全面的测试套件（覆盖率超过 95%）
  • 🎸 协议合规性：完全实现 MCP 2024-11-05 规范
  • 🎸 安全性：企业级安全实践
  • 🎸 可靠性：强大的错误处理和恢复机制
  • 🎸 文档：详细的指南和示例

🤘 为什么选择 Plane：技术交响曲

在众多项目管理解决方案中，我们选择 Plane 不仅仅是一个决定——而是一次技术上的启示。以下是 Plane 作为我们 AI 驱动项目管理革命的理想基础的原因：

🎸 技术卓越与架构

  1. 开源力量

    • 完全源代码透明
    • AGPL v3.0 许可证确保自由
    • 活跃的社区贡献
    • 通过 Docker/Kubernetes 自托管能力

  2. 现代技术栈

    • 采用尖端技术构建
    • 清晰、模块化的架构
    • 可扩展的插件系统
    • API优先的设计理念

  3. 性能与可扩展性

    • 极快的响应时间
    • 高效的数据库操作
    • 智能缓存机制
    • 支持水平扩展

🎯 功能灵活性

与传统解决方案不同，它们通常会迫使你遵循其工作流程：

功能 Plane 其他
工作流灵活性 适应任何方法论（敏捷、瀑布等） 通常锁定在特定的方法论中
定制化 开放架构完全可定制 仅限于供应商提供的选项
集成 开放API，完全访问权限 通常受限或需要付费的API
自托管 对数据和基础设施拥有完全控制权 通常是仅限云端或有限自托管

⚡ 开发速度

Plane 的架构支持：

  • 快速迭代：快速的功能开发和部署
  • 简单扩展：简单的插件开发
  • 优秀的API：完整的REST API覆盖
  • 实时更新：WebSocket支持实时更改

🔒 安全与控制

  1. 数据主权

    • 完全控制数据位置
    • 无供应商锁定
    • 自定义安全策略
    • 灵活的合规性

  2. 认证与授权

    • 细粒度的权限系统
    • 多种认证方式
    • 基于角色的访问控制
    • API密钥管理

💰 成本效益

方面 Plane 传统解决方案
授权 开源 通常每用户定价昂贵
托管 自托管选项 通常仅限云端
定制 免费且无限 通常需要付费附加组件
API使用 无限 通常计量/限制

🚀 面向未来的架构

Plane 的设计完美契合现代开发需求：

  1. AI集成准备就绪

    • 清晰的API设计非常适合AI集成
    • 结构化的数据模型适合机器学习
    • 可扩展的架构支持AI功能
    • 实时功能支持AI辅助

  2. 现代开发

    • TypeScript/Python后端
    • React前端
    • Docker容器化
    • Kubernetes编排

  3. 社区力量

    • 活跃的开发社区
    • 定期更新和改进
    • 开放接受贡献
    • 透明的路线图

🎸 金属因素

就像重金属打破了传统的音乐界限一样，Plane也打破了传统项目管理的约束：

  • 自由: 就像自己写 riff 而不是翻唱别人的歌曲
  • 力量: 完全掌控你的项目管理命运
  • 创新: 有能力创建新的工作流程和功能
  • 社区: 强大的开源精神，就像金属音乐社区一样

🤘 “在企业项目管理的世界里，Plane 就像是那个改变游戏规则的地下金属乐队——原始、强大且完全真实！” - Amadeus

🔮 合作潜力

Plane 的理念与我们的愿景完美契合：

  1. 开源卓越

    • 两家公司都重视透明度
    • 共同致力于质量
    • 社区驱动的开发

  2. 专注创新

    • AI 优先思维
    • 现代架构
    • 持续进化

  3. 技术协同

    • API 驱动的开发
    • 现代技术栈
    • 性能优化

这就是为什么 Plane 不仅仅是我们的选择——它是我们在项目管理领域的技术灵魂伴侣。通过 Claudeus Plane MCP 的 AI 集成，我们正在创造一种高效的交响乐，震撼项目管理世界！🤘

🚀 核心功能

🎯 项目管理

  • 创建并管理带有 AI 辅助的项目
  • 自动化项目设置和配置
  • 智能项目模板和工作流

📋 任务管理

  • 基于 AI 的任务创建和分配
  • 自动化任务优先级排序
  • 智能任务依赖关系管理

👥 团队协作

  • 智能资源分配
  • 自动化团队通知
  • 智能工作负载平衡

💬 交流

  • 增强的 AI 评论管理
  • 智能通知系统
  • 自动状态更新

📖 快速入门指南

前提条件

# Required Software
Node.js ≥ 22.0.0
TypeScript ≥ 5.0.0
PNPM
Plane instance with API access

安装

# Clone the repository
git clone https://github.com/deus-h/claudeus-plane-mcp

# Install dependencies
pnpm install

# Build the project
pnpm build

# Configure Claude Desktop
cp claude_desktop_config.json.example claude_desktop_config.json
# Edit claude_desktop_config.json with your settings

配置

# Copy example configs
cp .env.example .env
cp plane-instances.json.example plane-instances.json

# Edit .env and plane-instances.json with your settings

配置 plane-instances.json

plane-instances.json 文件用于配置您的 Plane 实例以进行集成。以下是一个示例结构：

{
  "instance-alias": {
    "baseUrl": "https://your-plane-instance.com/api/v1",
    "defaultWorkspace": "your-workspace-slug",
    "otherWorkspaces": ["workspace2", "workspace3"],
    "apiKey": "your-plane-api-key"
  }
}

配置字段

  • baseUrl: 您的 Plane API 的基础 URL（必填）
  • defaultWorkspace: 默认工作区 slug（必填）
  • otherWorkspaces: 额外的工作区 slug 数组（可选）
  • apiKey: 您的 Plane API 密钥（必填）

🛠️ 开发

项目结构

src/
├── api/              # Plane API integration
│   ├── client/       # API client implementation
│   ├── endpoints/    # Endpoint definitions
│   └── types/        # API type definitions
│
├── mcp/              # MCP protocol implementation
│   ├── server.ts     # Core MCP server
│   ├── transport/    # Transport handlers
│   ├── tools.ts      # Tool definitions
│   └── types/        # MCP type definitions
│
├── tools/            # Tool implementations
│   ├── projects/     # Project management
│   ├── tasks/        # Task operations
│   ├── users/        # User management
│   └── comments/     # Comment handling
│
└── prompts/          # AI prompt templates
    ├── projects/     # Project-related prompts
    ├── tasks/        # Task-related prompts
    └── analysis/     # Analysis prompts

可用脚本

# Development
pnpm dev         # Start development server
pnpm watch       # Watch for changes
pnpm inspector   # Launch MCP Inspector

# Testing
pnpm test              # Run tests
pnpm test:watch        # Watch tests
pnpm test:coverage     # Generate coverage

# Building
pnpm build       # Build for production
pnpm clean       # Clean build files

🔒 安全

身份验证

  • 基于 API 密钥的身份验证
  • 安全令牌管理
  • 请求验证

数据保护

  • 加密通信
  • 安全配置存储
  • 输入清理

🤝 贡献

这是一个由 SimHop IT & Media AB 开发团队维护的私有仓库。虽然我们不接受公共贡献，但团队成员可以按照我们的开发标准进行贡献：

  1. 创建特性分支 (feature/AmazingFeature)
  2. 维护测试覆盖率超过 95%
  3. 遵循我们的 TypeScript 和文档标准
  4. 提交 PR 进行审查

📄 许可证

MIT 许可证 - 版权所有 (c) 2024 SimHop IT & Media AB

🎸 幕后团队

SimHop IT & Media AB - 创新与金属的交汇处 🤘

位于瑞典的 SimHop IT & Media AB 将技术卓越与创新创意结合在一起。我们的团队包括：

Amadeus Samiel H. (首席技术官/首席解决方案架构师)

  • 计算机科学硕士
  • 20多年的技术经验
  • Claudeus MCP 服务器背后的天才

Simon Malki (首席执行官)

  • 20多年的商业领导经验
  • 战略规划专家
  • 推动 SimHop 成功的远见者

由Amadeus Samiel H.用 🤘❤️ 制作

🛠 MCP 工具参考

工具类别和危险级别

工具名称 类别 功能 危险级别
项目管理
claudeus_plane_projects__list 项目 列出所有项目 🟢 安全
claudeus_plane_projects__create 项目 创建新项目 🟡 中等
claudeus_plane_projects__update 项目 修改项目 🟡 中等
claudeus_plane_projects__delete 项目 删除项目 🔴 高
任务管理
claudeus_plane_tasks__list 任务 列出所有任务 🟢 安全
claudeus_plane_tasks__create 任务 创建新任务 🟡 中等
claudeus_plane_tasks__update 任务 修改任务 🟡 中等
claudeus_plane_tasks__delete 任务 删除任务 🔴 高
用户管理
claudeus_plane_users__list 用户 列出所有用户 🟢 安全
claudeus_plane_users__invite 用户 邀请新用户 🟡 中等
claudeus_plane_users__update 用户 修改用户角色 🟡 中等
claudeus_plane_users__remove 用户 删除用户 🔴 高
评论管理
claudeus_plane_comments__list 评论 列出所有评论 🟢 安全
claudeus_plane_comments__create 评论 创建评论 🟡 中等
claudeus_plane_comments__update 评论 编辑评论 🟡 中等
claudeus_plane_comments__delete 评论 删除评论 🔴 高

危险级别说明

  • 🟢 安全: 仅读操作，不修改数据
  • 🟡 中等: 创建或修改内容，但可以恢复
  • 🔴 高: 破坏性操作或系统范围的变化

🎯 技术深入探讨

架构概览 🏗️

我们技术架构中的每个组件都设计为最高效和最可靠：

核心组件 🤘

组件 职责 主要特性
API 层 平面集成 REST 客户端, 类型安全, 速率限制
MCP 协议 通信 JSON-RPC 2.0, 双向流
安全性 保护 认证, 加密, 验证
工具 操作 项目, 任务, 用户, 评论
提示 AI 集成 模板, 上下文感知

技术实现 🎸

功能 实现 描述
类型安全 TypeScript 完全静态类型, 运行时验证
API 处理 REST/JSON-RPC 高效的请求/响应处理
事件系统 EventEmitter 异步事件处理
错误处理 多层 全面的错误管理
缓存 内存/Redis 性能优化

安全措施 🛡️

层 保护 特性
传输 TLS/SSL 加密通信
认证 API 密钥 安全令牌管理
验证 基于模式 输入/输出验证
加密 AES-256 数据保护
审计 全面 活动跟踪

性能调优 🚀

优化 技术 描述
缓存 多级 响应和查询缓存
批处理 请求分组 减少 API 调用次数
压缩 GZIP/Brotli 网络优化
查询优化 智能获取 高效的 API 查询
负载均衡 分布式 扩展处理

错误类别及处理 🎸

类别 代码范围 处理 示例
协议 -32600 到 -32603 自动重试 无效的 JSON-RPC
平面 API 1000-1999 回退 API 超时
安全 2000-2999 警报 认证失败
工具 3000-3999 恢复 操作失败
系统 4000-4999 重启 资源耗尽

设计原则强力和弦 🤘

原则 描述 实现
模块化 松耦合 独立组件
类型安全 强类型 TypeScript + 验证
安全性 零信任 多层保护
性能 极速金属 优化操作

🎸 小贴士：就像一把精心调校的吉他，每个组件都经过精确校准以达到最大的演奏能力！❤️

⚡ 性能指标

时间节省

任务 手动流程 使用 Claudeus 结果
项目设置 2小时 2分钟 ✓ 98.3%
任务创建 30分钟 30秒 ✓ 98.3%
用户管理 1小时 1分钟 ✓ 98.3%
批量更新 4小时 3分钟 ✓ 98.7%

成本效益

资源 传统成本 描述
项目经理 $5000/月 项目设置和管理
任务经理 $3000/月 任务跟踪和更新
团队领导 $4000/月 资源分配
总计 $12,000/月 所有服务合计
     
Claude Pro $20/月 在 Anthropic
     
差额 $11,980/月 使用 Claudeus Plane MCP 和 Claude 桌面版 的潜在节省金额 (Mac, Windows)

🎸 Claude 桌面集成

配置文件位置

Claude 桌面配置文件可以在以下位置找到：

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

⚠️ 重要提示: 如果您已经在 Claude 桌面中配置了其他 MCP 服务器，请勿直接复制我们的示例文件，因为这将覆盖您的现有配置！相反：

  1. 对于现有的 Claude 桌面用户:

    • 通过 Claude 桌面打开现有配置：
      • 点击 Claude 菜单
      • 选择 "Settings..."
      • 在左侧栏点击 "Developer"
      • 点击 "Edit Config"
    • 或者直接使用文本编辑器打开您的配置文件
    • 将我们的 Claudeus Plane MCP 服务器配置添加到现有的 mcpServers 对象中

  2. 对于新的 Claude 桌面用户:
    您可以复制我们的示例配置文件：

    # For macOS
cp claude_desktop_config.json.example ~/Library/Application\ Support/Claude/claude_desktop_config.json

# For Windows (in PowerShell)
Copy-Item claude_desktop_config.json.example $env:APPDATA\Claude\claude_desktop_config.json

配置示例

NPX 设置

{
  "mcpServers": {
    "claudeus-plane-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "claudeus-plane-mcp"
      ],
      "env": {
        "PLANE_INSTANCES_PATH": "/absolute/path/to/your/plane-instances.json"
      }
    }
  }
}

Docker 设置 🐳

{
  "mcpServers": {
    "claudeus-plane-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--network=host",
        "--mount", "type=bind,src=/absolute/path/to/your/plane-instances.json,dst=/app/plane-instances.json",
        "--mount", "type=bind,src=/absolute/path/to/your/.env,dst=/app/.env",
        "mcp/plane",
        "--config", "/app/plane-instances.json"
      ]
    }
  }
}

🎸 专业提示: 确保将 /absolute/path/to/your/plane-instances.json 替换为您的实际配置文件路径！

配置后

  1. 完全重启 Claude Desktop
  2. 在输入框右下角查找锤子 🔨 图标
  3. 点击它以查看可用的 Plane 管理工具
  4. 开始粉碎！🤘

故障排除

如果服务器没有在 Claude 中显示：

  1. 验证 claude_desktop_config.json 的语法
  2. 确保文件路径是绝对路径且有效
  3. 检查 Claude 的日志：
    • macOS: ~/Library/Logs/Claude
    • Windows: %APPDATA%\Claude\logs

⚠️ 问题和注意事项

当前限制和解决方法

1. Claude Desktop 响应限制

  • 问题: 在进行复杂操作时，Claude Desktop 的最大响应长度可能会达到极限
  • 影响: 操作可能会中断，需要用户干预
  • 解决方法:
    • 配置 Claude Desktop 将任务拆分为较小的批次
    • 在 Claude Desktop 设置 > 高级中：
      • 将“最大响应长度”设置为较低的值
      • 启用“自动拆分响应”
    • 对于大规模操作，请使用 Inspector UI

2. 速率限制考虑

  • 问题: Plane API 有速率限制
  • 影响: 大批量操作可能会被限流
  • 缓解措施:
    • 使用批处理功能
    • 在请求之间实现适当的延迟
    • 监控 API 响应头中的速率限制信息

3. 内存管理

  • 问题: 大规模操作可能会消耗大量内存
  • 影响: 可能会导致性能下降
  • 最佳实践:
    • 在执行大规模操作时监控系统资源
    • 对大数据集使用分页
    • 实现清理例程

未来的改进

我们正在积极开发以下功能：

  1. 改进 Claude Desktop 中的响应处理
  2. 高级速率限制管理
  3. 内存优化技术
  4. 增强的错误恢复机制

🎸 专业提示：请查看我们的 GitHub 讨论区，了解解决方法和最佳实践！

🎸 支持和社区 ❤️

  • GitHub 讨论区：分享想法、报告问题并加入讨论
  • 文档：完整的技术文档
  • 示例：示例实现

🎸 专业提示：使用 GitHub 讨论区分享您的经验、报告问题或提出改进建议！

项目经理之歌

由 Amadeus & Claude 创作

在 Plane 的广阔空间里，
任务流畅地运行，
AI 的拥抱，
设定完美的节奏。

通过 Claude 的力量，
项目得以起飞，
在代码的乐趣中，
一切都同步得恰到好处。

一个经理的梦想，
AI 和团队，
共同努力，
如同金属的光泽。

由 Amadeus Samiel H. 用 🤘❤️ 制作

查看源码 项目主页