Ccc0168 Modes MCP Server

🚀 模式 MCP 服務器

模式 MCP 服務器用於管理 Roo 的自定義操作模式，能提供對模式配置和管理的程序化控制，可有效提升模式管理的效率和靈活性。

🚀 快速開始

模式 MCP 服務器為 Roo 的自定義操作模式管理提供了便捷的程序化控制方式。你可以按照以下步驟快速搭建並使用該服務器。

✨ 主要特性

• 支持完整的 CRUD 操作（創建、讀取、更新、刪除）自定義模式，方便對模式進行全面管理。
• 使用 Zod 進行架構驗證，確保數據的準確性和一致性。
• 具備文件系統監控功能，可即時檢測配置更改。
• 採用標準 MCP 錯誤代碼處理，便於快速定位和解決問題。
• 支持原子文件操作，保證文件操作的完整性。

📦 安裝指南

# 克隆倉庫
git clone https://github.com/mkc909/modes-mcp-server.git
cd modes-mcp-server

# 安裝依賴項
npm install

# 構建項目
npm run build

📚 詳細文檔

配置說明

1. 環境變量

複製 .env.example 到 .env 並根據需要進行調整：

cp .env.example .env

可用的環境變量：

• MODES_CONFIG_PATH：自定義模式配置文件路徑（默認值： %APPDATA%/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_custom_modes.json）

2. 自定義模式配置

創建一個 JSON 文件用於您的自定義模式配置。查看 examples/modes.example.json 以獲取格式：

{
  "customModes": [
    {
      "slug": "example-mode",
      "name": "示例模式",
      "roleDefinition": "描述該模式的能力和職責的角色定義。",
      "groups": [
        "read",
        ["edit", {
          "fileRegex": "\\.md$",
          "description": "只能編輯 Markdown 文件"
        }],
        "command",
        "other"
      ],
      "customInstructions?: string;  // 可選的額外說明
    }
  ]
}

3. MCP 配置

在 MCP 中配置此服務器：

{
  "servers": {
    "modes-server": {
      "url": "http://localhost:3000",
      "plugins": ["custom-modes"]
    }
  },
  "tools": {
    "custom-modes": {
      "server": "modes-server",
      "configFile": "%APPDATA%/Code/User/globalStorage/rooveteraryinc.custom-modes/config.json"
    }
  }
}

開發流程

1. 修改 src/ 中的源代碼
2. 構建項目：

npm run build

3. 啟動服務器：

npm start

最佳實踐

1. 模式選擇

• 根據任務選擇合適的模式
• 遵循特定於模式的工作流程
• 使用指定的工具組

2. 模式轉換

• 按照自然轉換流程進行操作
• 完成當前模式的任務
• 在模式之間保留上下文

3. 配置管理

• 在保存前驗證更改
• 保持清晰的角色定義
• 文檔記錄模式的能力

錯誤處理

該服務器使用標準 MCP 錯誤代碼：

• InvalidParams：輸入參數無效或未找到模式
• MethodNotFound：請求的工具未知
• InternalError：文件系統錯誤或其他內部問題

測試說明

參見 TESTING.md 瞭解全面的測試用例和驗證程序。

貢獻指南

1. 叉克隆倉庫
2. 創建功能分支
3. 提交拉取請求
4. 遵循編碼標準

📄 許可證

本項目採用 MIT License，詳情請參閱 LICENSE。