Auralis Commander

🚀 Auralis Commander

軽量なWindows MCPサーバーで、少ないリソースで多くのことを実現します。

🚀 クイックスタート

Auralis Commanderは、既存のソリューションが重すぎたり機能が制限されていたりする問題を解決するために開発されました。以下のセクションでは、その理由や主な利点、インストール方法、使用例などを詳しく説明します。

✨ 主な機能

🎯 スマートな設計

1つのprocess_interactiveツールが、Desktop Commanderの5つの別々のツールを置き換えます。

• start_process → process_interactive { action: "start" }
• read_process_output → process_interactive { action: "read" }
• interact_with_process → process_interactive { action: "write" }
• force_terminate → process_interactive { action: "kill" }
• list_sessions → process_interactive { action: "list" }

📦 バッチ操作

1回の呼び出しで複数のファイルを読み取ることができます。

file_read { paths: ["config.json", "package.json", ".env"] }
// すべてのファイルを一度に返し、エラーは他のファイルをブロックしません

⚡ Windowsネイティブ

PowerShellとWindowsのワークフローに最適化されています。WSLは不要で、Unixの前提条件もありません。

🪶 軽量

約14KBのコードで、起動が速く、メモリ使用量が少なく、コンテキストウィンドウの使用も少ないです。

📦 インストール

オプション1: npm（推奨）

npm install -g auralis-commander

オプション2: クローンしてビルド

git clone https://github.com/antonpme/auralis-commander
cd auralis-commander
npm install
npm run build

Claude Desktopの設定

claude_desktop_config.jsonに以下を追加します。

Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "auralis-commander": {
      "command": "node",
      "args": ["C:/path/to/auralis-commander/dist/index.js"]
    }
  }
}

Claude Desktopを再起動してサーバーを読み込みます。

💻 使用例

開発サーバーの起動

// Next.jsの開発サーバーを起動
process_interactive { 
  action: "start", 
  command: "npm run dev", 
  cwd: "C:/projects/my-app" 
}
// → { session_id: "a1b2c3", output: "ready on http://localhost:3000", is_running: true }

// 新しい出力を確認
process_interactive { action: "read", session_id: "a1b2c3", timeout_ms: 5000 }

// 完了したら停止
process_interactive { action: "kill", session_id: "a1b2c3" }

対話型Python REPL

process_interactive { action: "start", command: "python -u -i" }  // -u: バッファリングなし, -i: 対話型
// → { session_id: "x1y2z3", output: "Python 3.12.0\n>>>", is_running: true }

process_interactive { action: "write", session_id: "x1y2z3", input: "2 + 2\n" }
// → { output: "4\n>>>", is_running: true }

process_interactive { action: "write", session_id: "x1y2z3", input: "exit()\n" }
// → { output: "", is_running: false }

バッチ設定チェック

file_read { 
  paths: [
    "package.json",
    "tsconfig.json", 
    ".env",
    ".env.local"
  ]
}
// すべてのファイルを返します。存在しないファイルはエラーを表示しますが、他のファイルをブロックしません

システムの健全性チェック

system_info {}
// → { cpu: { model, cores, usage }, memory: { total, used, free }, disks: [...], uptime: "3d 14h" }

processes { sort_by: "memory", limit: 10 }
// → メモリ使用量が多い上位10個のプロセス

📚 ドキュメント

ツールの参照

シェルとシステム

ファイル

ディレクトリと検索

設定

ホームディレクトリにauralis-commander.jsonを作成してデフォルト設定を行います。

{
  "default_shell": "pwsh",
  "default_cwd": "C:/Projects",
  "max_file_read_mb": 50
}

アーキテクチャ

auralis-commander/
├── src/
│   ├── index.ts          # MCPサーバーのセットアップとツールの登録
│   ├── config.ts         # 設定管理
│   ├── tools/
│   │   ├── shell.ts      # shell_exec
│   │   ├── files.ts      # file_* と dir_* の操作
│   │   ├── search.ts     # 内容とファイル名の検索
│   │   ├── processes.ts  # プロセスのリスト表示と終了
│   │   ├── system.ts     # システム情報
│   │   └── interactive.ts # 対話型プロセスセッション
│   └── utils/
│       ├── powershell.ts # PowerShell実行ラッパー
│       ├── paths.ts      # パスの正規化
│       └── errors.ts     # エラー処理
├── dist/                 # コンパイルされたJavaScript
└── package.json

🔧 技術詳細

なぜAuralis Commanderなのか？

既存のMCPサーバーは、重すぎたり機能が制限されていたりする問題がありました。以下の表は、他のMCPサーバーとの比較を示しています。

Auralis Commander: シェル、ファイル、検索、プロセス、およびシステムをカバーする14のツールがあり、肥大化することがありません。

ツールの比較

🤝 コントリビュート

イシューとプルリクエストは大歓迎です。以下のことを守ってください。

1. ツールの焦点を維持し、機能の拡大を避けてください。
2. Windows互換性を維持してください。
3. 提出する前にClaude Desktopでテストしてください。

📄 ライセンス

MITライセンスです。自由に使用、変更、配布することができます。