モードMCPサーバー

Roo のカスタム動作モードを管理し、モードの構成と管理をプログラムで制御するための MCP サーバー。

特徴

• カスタムモードの完全なCRUD操作

• Zodによるスキーマ検証

• 設定変更を監視するファイルシステム

• 標準MCPエラーコードによるエラー処理

• アトミックファイル操作

Related MCP server: AX Local Operations MCP Server

インストール

# Clone the repository
git clone https://github.com/mkc909/modes-mcp-server.git
cd modes-mcp-server

# Install dependencies
npm install

# Build the project
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": "Example Mode",
      "roleDefinition": "Example role definition describing the mode's capabilities and responsibilities.",
      "groups": [
        "read",
        ["edit", {
          "fileRegex": "\\.md$",
          "description": "Can edit markdown files only"
        }],
        "command",
        "mcp"
      ],
      "customInstructions": "Example custom instructions for the mode."
    }
  ]
}

3. MCP設定

サーバー設定をMCP設定ファイル（通常は%APPDATA%/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json ）に追加します。フォーマットについてはexamples/mcp-settings.example.jsonを参照してください。

{
  "mcpServers": {
    "modes": {
      "command": "node",
      "args": ["/path/to/modes-mcp-server/build/index.js"],
      "env": {
        "MODES_CONFIG_PATH": "/path/to/custom/modes.json"
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

運用モードフレームワーク

サーバーは包括的な動作モードのセットを管理します。

コアシステムモード

1. 計画モード🎯

   • 戦略計画スペシャリスト

   • システム設計とリソース割り当て

   • プロジェクトロードマップの開発

2. 分析モード📊

   • データ分析の専門家

   • 指標の追跡と分析

   • パフォーマンス監視

3. リサーチモード🔍

   • システム研究スペシャリスト

   • ベストプラクティス研究

   • ソリューション探索

4. 実装モード⚙️

   • 運用実装エキスパート

   • システム展開

   • プロセス実行

5. トラブルシューティングモード🔧

   • システム解決スペシャリスト

   • 問題の特定

   • 問題解決

6. 品質管理モード✅

   • 品質保証エキスパート

   • システム検証

   • パフォーマンス検証

7. 統合モード🔄

   • システム統合スペシャリスト

   • システム間調整

   • ワークフローの最適化

8. ドキュメントモード📝

   • ナレッジマネジメントスペシャリスト

   • プロセスのドキュメント化

   • 標準メンテナンス

9. セッション管理モード⚡

   • セッション管理スペシャリスト

   • 日々のワークフローオーケストレーション

   • 国家管理

特殊モード

• トレードオペレーションマネージャー

  • 体系的な取引とリスク管理

  • 貿易文書と分析

  • 市場分析と戦略の最適化

モード遷移フロー

graph TD
    A[Planning] --> B[Research]
    B --> C[Implementation]
    C --> D[Integration]
    D --> E[Quality Control]
    E --> F[Analytics]
    F --> G[Troubleshooting]
    G --> H[Documentation]
    H --> A

利用可能なツール

リストモード

現在設定されているすべてのカスタム モードを一覧表示します。

取得モード

特定のモードの詳細をそのスラグで取得します。

パラメータ:

• slug : モードの一意の識別子

作成モード

新しいカスタム モードを作成します。

パラメータ:

• slug : 一意の識別子（小文字、数字、ハイフン）

• name : モードの表示名

• roleDefinition : モードの役割と機能の詳細な説明

• groups : 許可されたツールグループの配列

• customInstructions : (オプション) モードの追加指示

更新モード

既存のカスタム モードを更新します。

パラメータ:

• slug : 更新するモードの一意の識別子

• updates : 更新するフィールドを含むオブジェクト (name、roleDefinition、groups、customInstructions)

削除モード

カスタム モードを削除します。

パラメータ:

• slug : 削除するモードの一意の識別子

検証モード

モード構成を保存せずに検証します。

パラメータ:

• mode : 検証する完全なモード設定オブジェクト

モード構成スキーマ

interface CustomMode {
  slug: string;  // Lowercase letters, numbers, and hyphens only
  name: string;  // Display name
  roleDefinition: string;  // Detailed description
  groups: (string | [string, { fileRegex: string, description: string }])[];
  customInstructions?: string;  // Optional additional instructions
}

発達

1. src/のソースコードに変更を加える

2. プロジェクトをビルドします。

npm run build

3. サーバーを起動します。

npm start

ベストプラクティス

1. モード選択

   • タスクに適したモードを選択する

   • モード固有のワークフローに従う

   • 指定されたツールグループを使用する

2. モード遷移

   • 自然な移行の流れに従う

   • 現在のモードのタスクを完了する

   • モード間のコンテキストを保持する

3. 構成管理

   • 保存する前に変更を検証する

   • 明確な役割定義を維持する

   • ドキュメントモードの機能

エラー処理

サーバーは標準の MCP エラー コードを使用します。

• InvalidParams : 無効な入力パラメータまたはモードが見つかりません

• MethodNotFound : 不明なツールが要求されました

• InternalError : ファイルシステムエラーまたはその他の内部問題

テスト

包括的なテスト ケースと検証手順については、 TESTING.md を参照してください。

貢献

1. フォークリポジトリ

2. 機能ブランチを作成する

3. プルリクエストを送信する

4. コーディング標準に従う

ライセンス

MITライセンス - 詳細はライセンスを参照