Claudeus Plane MCP

⚠️ 私有存储库通知 ⚠️

这是一个仅供SimHop IT&Media AB团队成员使用的私有存储库。虽然代码可以在MIT许可下查看和使用，但我们目前不接受公众捐款。欢迎您分叉存储库并创建自己的版本，只要它与我们的包不完全相同或非常相似，以避免用户混淆。

🤘 Claudeus平面MCP 🎸

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

](https://github.com/deus-h/claudeus-plane-mcp/stargazers) ](https://www.npmjs.com/package/claudeus-plane-mcp) ](https://www.npmjs.com/package/claudeus-plane-mcp) ](https://github.com/deus-h/claudeus-plane-mcp/discussions) ](https://github.com/deus-h/claudeus-plane-mcp/network) ](https://smithery.ai/server/claudeus-plane-mcp)  

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

在人工智能驱动的项目管理快速发展的环境中，我们引入了Claudeus Plane MCP——克劳德的人工智能能力和Plane的项目管理平台之间的强大桥梁。我们的使命是：

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

为什么选择Claudeus Plane MCP？

建立在我们成功的Claudeus WordPress MCP的基础上，该服务器带来了相同的级别：

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

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

在项目管理解决方案的广阔领域中，我们选择Plane不仅仅是一个决定，更是一个技术启示。这就是为什么Plane成为我们AI驱动的项目管理革命的完美基础：

🎸 技术卓越与架构

1. 开源电源

- 完全透明的源代码 - AGPL v3.0许可证确保自由 - 积极的社区贡献 - Docker/Kubernetes的自托管功能

1. 现代技术栈

- 采用尖端技术打造 - 干净、模块化的架构 - 可扩展插件系统 - API-第一设计理念

1. 性能和可扩展性

- 闪电般快速的响应时间 - 高效的数据库操作 - 智能缓存机制 - 水平缩放支持

🎯 功能灵活性

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

⚡ 开发速度

Plane的架构能够：

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

🔒 安全与控制

1. 数据主权

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

1. 身份验证和授权

- 精细权限系统 - 多种身份验证方法 - 基于角色的访问控制 - API密钥管理

💰 成本效益

🚀 面向未来的架构

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

1. AI集成就绪

- 洁净的API设计，适用于人工智能集成 - 结构化数据模型是机器学习的理想选择 - AI功能的可扩展架构 - 人工智能辅助的实时功能

1. 现代发展

- Types/Python后端 - 基于React的前端 - Docker容器化 - Kubernetes编排

1. 社区电力

- 活跃的开发社区 - 定期更新和改进 - 对捐款开放 - 透明路线图

🎸 金属因素

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

• 自由比如写自己的即兴重复段，而不是翻唱
• 力量：完全控制您的项目管理命运
• 创新：能够创建新的工作流程和功能
• 社区：强大的开源精神，就像金属社区一样

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

🔮 合作潜力

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

1. 开源卓越

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

1. 创新的焦点

- AI优先思考 - 现代建筑 - 持续演化

1. 技术协同

- 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

配置plan-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：您的飞机API的基本URL（必需）
• 默认工作区：默认工作区段塞（必填）
• 其他工作区：附加工作区蛞蝓数组（可选）
• apiKey：您的飞机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以供审查

📄 许可证

麻省理工学院许可证-版权所有（c）2024 SimHop IT&Media AB

🎸 魔术背后的团队

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

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

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

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

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

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

由以下材料制成🤘❤️ 靠近 Amadeus Samiel H。

🛠 MCP工具参考

工具类别和危险等级

危险等级图例

• 🟢 安全：只读操作，不修改数据
• 🟡 适度：创建或修改内容，但可以恢复
• 🔴 高：破坏性行动或全系统变革

🎯 技术深度潜水

架构概述🏗️

我们技术架构中的每个组件都是为了实现最高的效率和可靠性而设计的：

核心组件🤘

技术实现🎸

安全措施🛡️

性能调整🚀

错误类别和处理🎸

动力弦的设计原则🤘

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

⚡ 性能指标

节省时间

成本效益

🎸 Claude桌面集成

配置位置

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

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• 窗户： %APPDATA%\Claude\claude_desktop_config.json

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

1. 适用于现有的Claude Desktop用户:

- 通过Claude Desktop打开现有配置： - 点击克劳德菜单 - 选择“设置…” - 点击左侧栏中的“开发人员” - 点击“编辑配置” - 或者直接在文本编辑器中打开配置文件 - 将我们的Claudeus Plane MCP服务器配置添加到您现有的 mcpServers 对象

1. 对于新的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 使用配置文件的实际路径！

配置后

1. 完全重新启动克劳德桌面
2. 寻找锤子🔨 输入框右下角的图标
3. 点击查看可用的平面管理工具
4. 开始粉碎！ 🤘

故障排除

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

1. 验证您的 claude_desktop_config.json 语法
2. 确保文件路径是绝对有效的
3. 查看克劳德的日志：

- macOS： ~/Library/Logs/Claude - 窗户： %APPDATA%\Claude\logs

⚠️ 问题和考虑

当前限制和解决方法

1.克劳德桌面响应限制

• 问题：在复杂操作期间，可以达到Claude Desktop的最大响应长度
• 影响：操作可能会中断，需要用户干预
• 变通方案:

- 配置Claude Desktop以将任务分成更小的批处理 - 在克劳德桌面设置>高级中： - 将“最大响应长度”设置为较低的值 - 启用“自动拆分响应” - 使用检查器UI进行大规模操作

2.利率限制考虑因素

• 问题：API飞机有费率限制
• 影响：批量操作可能会受到限制
• 缓解:

- 使用批处理功能 - 在请求之间实施适当的延迟 - 监视API响应标头以获取速率限制信息

3.内存管理

• 问题：大型操作可能会消耗大量内存
• 影响：潜在的性能下降
• 最佳实践:

- 在大型操作期间监控系统资源 - 对大型数据集使用分页 - 实施清理程序

未来改进

我们正在积极致力于：

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

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

🎸 支持和社区❤️

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

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

______________________________________________________________________

项目经理的赞歌

*通过Amadeus&克劳德*

______________________________________________________________________

*在飞机的广阔空间里，\ 任务流畅，\ AI的拥抱，\ 设定完美的节奏。*

*通过克劳德的力量，\ 项目起飞，\ 在代码的喜悦中，\ 所有同步都恰到好处。*

*管理者的梦想，\ AI和团队，\ 上游作业，\ 就像金属的光芒。*

______________________________________________________________________

由以下材料制成🤘❤️ 靠近 Amadeus Samiel H。