克劳德斯飞机MCP

Name: 克劳德斯飞机MCP
Author: deus-h

作者：deus-h3 星标更新：2025-01-31

安装使用来源：spider==github.com

项目介绍

⚠️ 私有仓库通知 ⚠️

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

🤘 Claudeus Plane MCP 🎸

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

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

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

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

为什么选择Claudeus Plane MCP？

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

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

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

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

🎸 技术卓越与架构

开源力量
- 全源码透明
- AGPL v3.0许可证确保自由
- 活跃的社区贡献
- 使用Docker/Kubernetes进行自托管能力
现代技术堆栈
- 使用尖端技术构建
- 清晰、模块化的架构
- 扩展插件系统
- API优先设计哲学
性能与可扩展性
- 雷霆般的响应时间
- 高效的数据库操作
- 智能缓存机制
- 支持横向扩展

🎯 功能灵活性

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

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

⚡ 开发速度

Plane的架构使：

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

🔒 安全与控制

数据主权
- 对数据位置的完全控制
- 没有供应商锁定
- 自定义安全策略
- 符合性灵活性
认证与授权
- 细粒度权限系统
- 多种认证方法
- 基于角色的访问控制
- API密钥管理

💰 成本效益

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

🚀 未来就绪架构

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

AI集成准备
- 清晰的API设计适合AI集成
- 结构化的数据模型适合机器学习
- 扩展架构用于AI特性
- 实时能力用于AI辅助
现代开发
- TypeScript/Python后端
- React前端
- Docker容器化
- Kubernetes编排
社区力量
- 积极的开发社区
- 定期更新和改进
- 接受贡献
- 透明路线图

🎸 金属因素

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

自由：像写自己的即兴演奏而不是演奏翻唱曲目
力量：对项目管理命运的完全控制
创新：创造新工作流和特性的能力
社区：强烈的开源精神，就像金属社区一样

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

🔮 合作潜力

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

开源卓越
- 两家公司都重视透明度
- 共同致力于质量
- 社区驱动的开发
创新焦点
- AI优先思维
- 现代架构
- 持续进化
技术协同
- API驱动的开发
- 现代技术堆栈
- 性能关注

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

🚀 核心功能

🎯 项目管理

使用AI辅助创建和管理项目
自动项目设置和配置
智能项目模板和工作流

📋 任务管理

使用AI创建和分配任务
自动任务优先级排序
智能任务依赖关系管理

👥 团队协作

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

💬 通信

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

📖 快速入门指南

先决条件

# 所需软件
Node.js ≥ 22.0.0
TypeScript ≥ 5.0.0
PNPM
具有API访问权限的Plane实例

安装

# 克隆仓库
git clone https://github.com/deus-h/claudeus-plane-mcp

# 安装依赖
pnpm install

# 构建项目
pnpm build

# 配置Claude桌面
cp claude_desktop_config.json.example claude_desktop_config.json
# 编辑claude_desktop_config.json以包含您的设置

配置

# 复制示例配置文件
cp .env.example .env
cp plane-instances.json.example plane-instances.json

# 编辑.env和plane-instances.json以包含您的设置

配置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集成
│   ├── client/       # API客户端实现
│   ├── endpoints/    # 端点定义
│   └── types/        # API类型定义
│
├── mcp/              # MCP协议实现
│   ├── server.ts     # 核心MCP服务器
│   ├── transport/    # 传输处理器
│   ├── tools.ts      # 工具定义
│   └── types/        # MCP类型定义
│
├── tools/            # 工具实现
│   ├── projects/     # 项目管理
│   ├── tasks/        # 任务操作
│   ├── users/        # 用户管理
│   └── comments/     # 评论处理
│
└── prompts/          # AI提示模板
    ├── projects/     # 项目相关提示
    ├── tasks/        # 任务相关提示
    └── analysis/     # 分析提示

可用脚本

# 开发
pnpm dev         # 启动开发服务器
pnpm watch       # 监视更改
pnpm inspector   # 启动MCP Inspector

# 测试
pnpm test              # 运行测试
pnpm test:watch        # 监视测试
pnpm test:coverage     # 生成覆盖率报告

# 构建
pnpm build       # 为生产构建
pnpm clean       # 清理构建文件

🔒 安全

认证

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

数据保护

加密通信
安全配置存储
输入净化

🤝 贡献

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

创建功能分支（feature/AmazingFeature）
维护测试覆盖率高于95%
遵循我们的TypeScript和文档标准
提交PR进行审查

📄 许可

🎸 创造奇迹的团队

SimHop IT & Media AB - 创新与金属相遇的地方 🤘

位于瑞典，SimHop IT & Media AB汇集了技术卓越和创意创新。我们的团队包括：

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

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

Simon Malki (CEO)

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层	Plane集成	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
Plane API	1000-1999	备用方案	API超时
安全性	2000-2999	警报	认证失败
工具	3000-399