Castplan MCP

🚀 CastPlan MCP：智能氛围编码环境

借助人工智能驱动的智能辅助，变革你的编码体验 —— CastPlan MCP 打造了一个自然、直观的氛围编码环境，让人工智能能够深入理解你的项目，并助力你流畅编码。

体验编码的未来 —— 人工智能理解你的意图、预判你的需求，让你在编码过程中保持专注，不被打断。

🚀 快速开始

方法一：使用 npm（推荐）

# 全局安装，以便即时访问
npm install -g @castplan/automation-mcp@2.1.0

# 初始化项目以开启氛围编码
castplan-init

方法二：直接从 GitHub 安装

# 克隆并设置项目
git clone https://github.com/Ghostseller/CastPlan_mcp.git
cd CastPlan_mcp
npm install && npm run build

# 添加到 Claude Desktop 配置中
npm run configure

方法三：使用 Python 桥接

pip install castplan-automation==2.1.0
castplan-configure --ai-tool claude

✨ 主要特性

🌊 什么是氛围编码？

氛围编码 是一种自然、直观的编码方式，你可以与你的人工智能助手无缝协作：

• 🧠 真正“理解”你项目的人工智能 —— 理解项目上下文、模式和架构
• 🔄 持续学习与适应 —— 随着时间推移，不断提升对你的帮助能力
• ⚡ 即时、智能的响应 —— 无需反复解释上下文
• 🎯 预判式辅助 —— 提供符合你编码风格和项目需求的建议
• 🌐 全球可访问性 —— 为国际团队提供多语言支持

✨ 氛围编码特性展示

🎯 上下文感知智能

// 你输入：
"添加用户认证"

// 人工智能理解你的项目并给出建议：
// - 使用你现有的 JWT 服务模式
// - 遵循你的中间件结构
// - 维持你的错误处理方式
// - 自动更新相关文档

🔄 持续学习

// 合作一段时间后：
人工智能了解你的偏好：
✓ 更喜欢使用 async/await 而非 promises
✓ 使用特定的命名约定
✓ 遵循你的测试模式
✓ 理解你的架构决策

⚡ 即时项目理解

// 无需再反复解释：
"我当前的数据库架构是什么？"
"如何处理认证？"
"我应该在哪里添加这个新功能？"

// 人工智能通过项目分析已经知晓答案

🌐 全球团队支持

// 首尔的团队
developer.setLocale('ko-KR');
// 获取韩语文档和建议

// 圣保罗的团队
developer.setLocale('pt-BR');
// 获取葡萄牙语上下文和帮助

🌟 氛围编码场景

🎨 前端开发

开发者：“我需要一个响应式导航栏组件”

使用 CastPlan MCP：
✓ 分析你现有的组件模式
✓ 使用你的 CSS 框架（Tailwind/Bootstrap）
✓ 遵循你的组件结构
✓ 包含适当的可访问性特性
✓ 更新组件文档
✓ 建议集成点

🔧 后端开发

开发者：“添加一个新的文件上传 API 端点”

使用 CastPlan MCP：
✓ 理解你的 REST API 结构
✓ 使用你的认证中间件
✓ 遵循你的错误处理模式
✓ 实现适当的文件验证
✓ 更新 API 文档
✓ 建议测试用例

🚀 DevOps 与部署

开发者：“为这个项目设置 CI/CD”

使用 CastPlan MCP：
✓ 分析你的项目结构
✓ 检测你的技术栈和依赖项
✓ 创建合适的构建管道
✓ 配置特定环境的设置
✓ 设置监控和警报
✓ 记录部署过程

🧪 测试与质量保证

开发者：“我需要全面的测试”

使用 CastPlan MCP：
✓ 分析你的测试模式
✓ 生成单元测试和集成测试
✓ 创建测试数据和模拟对象
✓ 设置覆盖率报告
✓ 集成到你的 CI 管道中
✓ 维护测试文档

📦 安装指南

上述快速开始部分已详细介绍了三种安装方式，分别是使用 npm、直接从 GitHub 安装以及使用 Python 桥接，可根据自身需求选择合适的安装方法。

💻 使用示例

基础用法

// 你输入：
"Add user authentication"

// AI 理解你的项目并给出建议：
// - Uses your existing JWT service pattern
// - Follows your middleware structure  
// - Maintains your error handling approach
// - Updates relevant documentation automatically

高级用法

// 当你有更复杂的需求时，如对多个模块进行集成开发：
// AI 会根据项目的整体架构和之前的编码习惯，提供更全面的解决方案和代码建议

📚 详细文档

🏗️ 智能四层架构

CastPlan MCP 通过复杂的四层架构实现氛围编码：

🔌 第一层：MCP 协议层

人工智能 ↔ 工具通信

• 直接的人工智能集成：与 Claude、Cursor 等人工智能工具无缝连接
• 实时数据交换：与人工智能助手即时共享项目上下文
• 通用兼容性：可与任何支持 MCP 的人工智能工具配合使用

🛡️ 第二层：基础设施层

自动恢复与健康监控

• 断路器模式：从服务故障中自动恢复
• 优雅降级：在出现问题时维持核心功能
• 健康监控：持续进行系统健康检查和自我修复
• 性能优化：智能管理资源和缓存

🧠 第三层：增强服务层

人工智能分析与智能缓存

• 人工智能分析服务：深入理解代码模式和项目架构
• Redis 缓存集成：高性能缓存，实现即时响应
• 生命周期管理：智能跟踪文档和项目的生命周期
• 智能自动化：基于上下文的任务自动化和工作流优化

⚙️ 第四层：核心服务层

业务逻辑与工作流自动化

• BMAD 服务：构建、监控、分析、部署工作流自动化
• 文档服务：智能生成和维护文档
• 钩子系统：可定制的自动化触发器和工作流
• 多语言支持：支持国际化，自动检测语言环境

🛠️ 可用的氛围编码工具

📋 项目管理与分析

• bmad_service - 构建、监控、分析、部署工作流
• ai_analysis_service - 深度代码和架构分析
• lifecycle_service - 文档和项目生命周期管理

📚 文档与知识管理

• documentation_service - 智能文档生成
• tree_service - 项目结构可视化和分析
• hooks_service - 自定义自动化和工作流触发器

🔧 开发与自动化

• datetime_service - 支持时区的智能日期/时间处理
• file_connection_service - 智能文件关系跟踪
• redis_cache_service - 高性能缓存和状态管理

🌐 多语言支持

CastPlan MCP 支持全球开发团队：

• 🇺🇸 英语 - 全功能支持
• 🇰🇷 韩语 - 原生韩语支持
• 🇯🇵 日语 - 日语本地化
• 🇨🇳 中文 - 简体和繁体中文支持
• 🇪🇸 西班牙语 - 西班牙语支持
• 🇫🇷 法语 - 法语本地化
• 🇩🇪 德语 - 德语支持
• 🇧🇷 葡萄牙语（巴西） - 葡萄牙语（巴西）支持

🎯 性能与可靠性

⚡ 闪电般快速

• 缓存查询响应时间 < 50ms
• 基于 Redis 的缓存，实现即时项目上下文访问
• 智能预取可能需要的信息
• 优化的数据结构，减少内存使用

🛡️ 企业级可靠性

• 99.9% 的正常运行时间，采用断路器模式
• 自动故障转移和优雅降级
• 全面的错误恢复和日志记录
• 健康监控和自我修复能力

📊 智能资源管理

• 基于使用模式的自适应缓存策略
• 针对大型代码库的内存优化
• 智能清理未使用的数据
• 资源池化，实现最佳性能

🔧 技术细节

🔌 配置氛围编码

对于 Claude Desktop

{
  "mcpServers": {
    "castplan-ultimate": {
      "command": "node",
      "args": ["path/to/castplan-mcp/dist/index.js"],
      "env": {
        "CASTPLAN_MODE": "vibe-coding",
        "CACHE_ENABLED": "true", 
        "AUTO_ANALYSIS": "true",
        "LOCALE": "auto"
      }
    }
  }
}

对于 Cursor

{
  "mcp": {
    "providers": [{
      "name": "castplan-vibe",
      "path": "dist/index.js",
      "config": {
        "vibeMode": true,
        "intelligentCaching": true,
        "autoLocale": true
      }
    }]
  }
}

🤝 贡献代码

我们欢迎大家贡献代码，以提升氛围编码体验：

# 设置开发环境
git clone https://github.com/Ghostseller/CastPlan_mcp.git
cd CastPlan_mcp
npm install

# 在开发模式下运行
npm run dev

# 运行测试
npm test

# 构建生产版本
npm run build

🔍 开发指南

• 代码质量：使用 ESLint + Prettier + TypeScript 严格模式
• 测试：使用 Jest 实现 100% 测试覆盖率
• 文档：使用 JSDoc 注释并更新 README
• 国际化：欢迎支持新语言

📖 文档与支持

• 📚 完整文档
• 🎥 视频教程
• 💬 社区 Discord
• 🐛 问题跟踪
• 📧 支持邮箱

📄 许可证

本项目采用 MIT 许可证，详情请参阅 LICENSE 文件。

我们怀着热忱为希望流畅编码的开发者打造了本项目。

准备好体验氛围编码了吗？ 🚀

npm install -g @castplan/automation-mcp@2.1.0
castplan-init

立即变革你的开发工作流程。