Ccc0168 Modes MCP Server

🚀 モード MCP サーバ

Roo のカスタム操作モードを管理するための MCP サーバです。モードの設定と管理をプログラムで制御できます。

✨ 主な機能

• カスタムモードの完全な 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

💡 ベストプラクティス

モード選択

• タスクに適したモードを選択します。
• モード固有のワークフローに従います。
• 指定されたツールグループを使用します。

モード変換

• 自然な変換フローに従って操作します。
• 現在のモードのタスクを完了します。
• モード間でコンテキストを保持します。

設定管理

• 保存する前に変更を検証します。
• 明確なロール定義を維持します。
• モードの機能を文書化します。

エラー処理

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

• InvalidParams：入力パラメータが無効またはモードが見つからない
• MethodNotFound：要求されたツールが不明
• InternalError：ファイルシステムエラーまたはその他の内部問題

テスト

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

コントリビューションガイド

1. リポジトリをフォークしてクローンします。
2. 機能ブランチを作成します。
3. プルリクエストを送信します。
4. コーディング標準に従います。

📄 ライセンス

MIT ライセンス - 詳細は LICENSE を参照してください。