⚠️私人仓库通知⚠️

这是 SimHop IT & Media AB 团队成员专属的私有代码库。虽然代码可在 MIT 许可证下查看和使用，但我们目前不接受公众贡献。欢迎您 fork 此代码库并创建您自己的版本，前提是您的版本不能与我们的软件包完全相同或过于相似，以免造成用户混淆。

🤘 克劳德斯飞机 MCP 🎸

“在你的位面领域释放人工智能的力量——为 MCP 卓越设定标准！” 🖤

🎯 我们的使命：利用人工智能提升项目管理

在人工智能项目管理领域快速发展的背景下，我们隆重推出 Claudeus Plane MCP，它是 Claude 人工智能功能与 Plane 项目管理平台之间的强大桥梁。我们的使命是：

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

为什么选择 Claudeus Plane MCP？

该服务器建立在我们成功的 Claudeus WordPress MCP 基础上，具有以下相同水平：

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

🤘 我们为什么选择《飞机：技术交响曲》

在浩瀚的项目管理解决方案领域中，我们选择 Plane 不仅仅是一个决定，更是一次技术上的启示。以下是 Plane 脱颖而出，成为我们 AI 驱动的项目管理革命的完美基础的原因：

🎸 技术卓越与架构

开源力量
- 完全源代码透明
- AGPL v3.0 许可证确保自由
- 积极的社区贡献
- Docker/Kubernetes 的自托管功能
现代技术栈
- 采用尖端技术打造
- 简洁、模块化的架构
- 可扩展的插件系统
- API-first 设计理念
性能和可扩展性
- 闪电般的响应时间
- 高效的数据库操作
- 智能缓存机制
- 水平扩展支持

🎯 功能灵活性

与强制您进入其工作流程的传统解决方案不同：

特征	飞机	其他的
工作流程灵活性	适应任何方法（敏捷、瀑布等）	常常局限于特定的方法论
定制	采用开放式架构，完全可定制	仅限于供应商提供的选项
一体化	开放 API，可完全访问	通常受限制或付费的 API
自托管	完全控制数据和基础设施	通常仅限云或有限的自托管

⚡ 开发速度

Plane 的架构可以实现：

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

🔒 安全与控制

数据主权
- 完全控制数据位置
- 不受供应商锁定
- 自定义安全策略
- 合规灵活性
身份验证和授权
- 细粒度的权限系统
- 多种身份验证方法
- 基于角色的访问控制
- API 密钥管理

💰 成本效益

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

🚀 面向未来的架构

Plane 的设计完全符合现代发展需求：

AI集成就绪
- 简洁的 API 设计非常适合 AI 集成
- 适合机器学习的结构化数据模型
- 可扩展的 AI 功能架构
- 人工智能辅助的实时功能
现代发展
- TypeScript/Python 后端
- 基于 React 的前端
- Docker 容器化
- Kubernetes 编排
社区力量
- 活跃的开发社区
- 定期更新和改进
- 开放贡献
- 透明的路线图

🎸 金属因素

就像重金属突破了传统音乐的界限一样，Plane 也摆脱了传统项目管理的限制：

自由：喜欢自己写即兴重复乐段，而不是翻唱
权力：完全掌控你的项目管理命运
创新：创建新工作流程和功能的能力
社区：强大的开源精神，就像金属社区一样

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

🔮 合作潜力

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

开源卓越
- 两家公司都重视透明度
- 共同致力于品质
- 社区驱动的发展
创新焦点
- 人工智能优先思维
- 现代建筑
- 持续进化
技术协同
- API驱动开发
- 现代技术堆栈
- 注重绩效

正因如此，Plane 不仅仅是我们的选择，更是我们在项目管理领域的技术灵魂伴侣。结合我们通过 Claudeus Plane MCP 实现的 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 ：附加工作区数组（可选）
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 开发团队维护的私有代码库。虽然我们不接受公开贡献，但团队成员可以按照我们的开发标准进行贡献：

创建功能分支（ feature/AmazingFeature ）
保持测试覆盖率在 95% 以上
遵循我们的 TypeScript 和文档标准
提交 PR 以供审核

📄 许可证

🎸 魔术背后的团队

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

SimHop IT & Media AB 总部位于瑞典，集卓越技术与创新创意于一体。我们的团队包括：

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

计算机科学硕士
20多年的卓越技术
Claudeus MCP 服务器背后的大师

西蒙·马尔基（首席执行官）

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，双向流
安全	保护	授权、加密、验证
工具	运营	项目、任务、用户、评论
提示	人工智能集成	模板、情境感知

技术实现🎸

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

安全措施🛡️

层	保护	特征
运输	TLS/SSL	加密通信
验证	API 密钥	安全令牌管理
验证	基于模式	输入/输出验证
加密	AES-256	数据保护
审计	综合的	活动追踪

性能调优🚀

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

错误类别和处理🎸

类别	代码范围	处理	例子
协议	-32600 至 -32603	自动重试	JSON-RPC 无效
平面 API	1000-1999	倒退	API 超时
安全	2000-2999	警报	授权失败
工具	3000-3999	恢复	操作失败
系统	4000-4999	重启	资源枯竭

设计原则 Power Chord 🤘

原则	描述	执行
模块化	松散耦合	独立组件
类型安全	强类型	TypeScript + 验证
安全	零信任	多层保护
表现	速度金属	优化运营

🎸 专业提示：就像一把调音精准的吉他，每个组件都经过精确校准，以实现最大的演奏能力！❤️

⚡ 绩效指标

节省时间

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

成本效益

资源	传统成本	描述
专案经理	每月5000美元	项目设置和管理
任务管理器	每月3000美元	任务跟踪和更新
团队负责人	每月4000美元	资源分配
全部的	每月12,000美元	所有服务合并

克劳德·普罗	每月 20 美元	在Anthropic

不同之处	每月11,980美元	使用Claudeus Plane MCP和 Claude Desktop ( Mac , Windows ) 的潜在节省

🎸 Claude 桌面集成

配置位置

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

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

⚠️重要提示：如果您已经在 Claude Desktop 中配置了其他 MCP 服务器，请勿直接复制我们的示例文件，因为它会覆盖您现有的配置！请执行以下操作：

对于现有的 Claude Desktop 用户：
- 通过 Claude Desktop 打开您现有的配置：
  - 点击克劳德菜单
  - 选择“设置...”
  - 点击左侧栏中的“开发者”
  - 点击“编辑配置”
- 或者直接在文本编辑器中打开你的配置文件
- 将我们的 Claudeus Plane MCP 服务器配置添加到您现有的mcpServers对象
对于新的 Claude Desktop 用户：您可以复制我们的示例配置文件：
# 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替换为配置文件的实际路径！

配置后

完全重启Claude Desktop
在输入框右下角寻找锤子🔨图标
点击查看可用的飞机管理工具
开始撕碎！🤘

故障排除

如果服务器没有出现在 Claude 中：

验证你的claude_desktop_config.json语法
确保文件路径是绝对的且有效的
查看 Claude 的日志：
- macOS： ~/Library/Logs/Claude
- Windows： %APPDATA%\Claude\logs

⚠️ 问题和注意事项

当前的限制和解决方法

1. Claude 桌面响应限制

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

2. 速率限制注意事项

问题：Plane API 有速率限制
影响：批量操作可能会受到限制
缓解措施：
- 使用批处理功能
- 在请求之间实施适当的延迟
- 监控 API 响应标头以获取速率限制信息

3.内存管理

问题：大型操作会消耗大量内存
影响：潜在的性能下降
最佳实践：
- 在大型操作期间监控系统资源
- 对大型数据集使用分页
- 实施清理例程

未来的改进

我们正在积极致力于：

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

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

🎸 支持和社区 ❤️

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

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

项目经理的赞歌

作者：Amadeus & Claude

在Plane广阔的空间里，
任务顺利完成，
AI的怀抱，
设定完美的步伐。

凭借克劳德的力量，
项目起飞，
在代码的喜悦中，
一切同步恰到好处。

经理人的梦想，
人工智能和团队，
上游工作，
就像金属的光泽。