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

立即變革你的開發工作流程。