Claude Command Runner

🚀 Claude Command Runner

Claude Command Runnerは、Claude Desktopとターミナルアプリケーションを橋渡しする強力なModel Context Protocol (MCP)サーバーです。これにより、シームレスなコマンド実行と、インテリジェントな出力取得が可能になり、包括的なv3.0の機能を備えています。

🚀 クイックスタート

v3.0の新機能

• 強化された自動取得機能：スマートなコマンド検出による段階的な遅延
• 安定性の向上：サーバーのクラッシュを修正し、持続的に実行可能
• データベース統合：SQLiteによるコマンド履歴と分析
• 設定システム：セキュリティと動作設定をカスタマイズ可能
• ビルドの知能化：コンパイルコマンドに対して自動的に長時間待機

概要

Claude Command Runnerは、Claudeが以下のことを可能にすることで、開発ワークフローを革新します。

• 会話から直接ターミナルコマンドを実行する
• インテリジェントなタイミングで自動的に出力をキャプチャする
• コマンド履歴とパターンを追跡する
• 設定可能なポリシーでセキュリティを維持する

✨ 主な機能

スマート自動取得機能

execute_with_auto_retrieveコマンドは、コマンドの種類をインテリジェントに検出し、待機時間を調整します。

• 高速コマンド (echo, pwd)：2 - 6秒
• 中程度のコマンド (git, npm)：最大20秒
• ビルドコマンド (swift build, make)：最大77秒
• テストコマンド：最大40秒

完全な機能セット

• ✅ 自動出力キャプチャによる双方向通信
• ✅ すべてのコマンドタイプに対する段階的な遅延システム
• ✅ コマンド履歴用のSQLiteデータベース
• ✅ 設定可能なセキュリティポリシー
• ✅ マルチターミナルサポート (Warpを推奨)
• ✅ 履歴に基づくコマンド提案

📦 インストール

前提条件

• macOS 13.0以降
• Swift 6.0+ (Xcode 16+)
• Claude Desktop
• サポートされているターミナル (Warpを強く推奨)

クイックインストール

1. クローンしてビルドする：

git clone https://github.com/M-Pineapple/claude-command-runner.git
cd claude-command-runner
./build.sh

2. Claude Desktopを設定する：MCP設定に以下を追加します。

{
  "claude-command-runner": {
    "command": "/path/to/claude-command-runner/.build/release/claude-command-runner",
    "args": ["--port", "9876"],
    "env": {}
  }
}

3. Claude Desktopを再起動する

💻 使用例

利用可能なツール

1. execute_command - 手動で出力を取得しながらコマンドを実行する
2. execute_with_auto_retrieve - インテリジェントな自動取得でコマンドを実行する ⭐
3. get_command_output - 手動でコマンドの出力を取得する
4. preview_command - 実行せずにコマンドをプレビューする
5. suggest_command - コマンドの提案を取得する

例のワークフロー

あなた: "私のSwiftプロジェクトをビルドして"
Claude: [実行: swift build]
[最大77秒間インテリジェントに待機]
Claude: "ビルドが正常に完了しました！これが出力です..."

📚 ドキュメント

設定

設定ファイルは~/.claude-command-runner/config.jsonにあります。

{
  "terminal": {
    "preferred": "auto",
    "fallbackOrder": ["Warp", "WarpPreview", "iTerm", "Terminal"]
  },
  "security": {
    "blockedCommands": ["rm -rf /", "format"],
    "maxCommandLength": 1000
  },
  "history": {
    "enabled": true,
    "maxEntries": 10000
  }
}

よくある質問

Q: サーバーが時々クラッシュするのはなぜですか？

A: これは以前のバージョンでの大きな問題でした。v3.0では、問題のあるバックグラウンドタスクを削除し、より安全な段階的な遅延システムを実装することで、サーバーの安定性を完全に修正しました。

Q: 自動取得はコマンドをどれだけ待機しますか？

A: コマンドの種類によって異なります。

• 単純なコマンド：6秒
• Git/npmコマンド：20秒
• ビルドコマンド：77秒
• 不明なコマンド：30秒

Q: Terminal.appやiTerm2でこれを使用できますか？

A: はい、基本的なコマンド実行はどのターミナルでも動作します。ただし、自動出力キャプチャと高度な機能にはWarp Terminalが必要です。ここから無料でWarpを入手してください。

Q: Claudeにコマンドを実行させるのは安全ですか？

A: はい！すべてのコマンドには手動での承認 (Enterキーを押す) が必要であり、設定ファイルでブロックされるコマンドとパターンを設定できます。Claudeはあなたの明示的な同意なしに何も実行することはできません。

Q: ビルドが77秒以上かかった場合はどうなりますか？

A: 自動取得はタイムアウトし、コマンドIDを提供します。その後、そのIDを使用してget_command_outputを使って結果を取得できます。

Q: コマンド履歴はどこに保存されますか？

A: ~/.claude-command-runner/claude_commands.dbのSQLiteデータベースに保存されます。すべてのコマンド、出力、終了コード、および実行時間が追跡されます。

Q: このプロジェクトに貢献することはできますか？

A: もちろんです！リポジトリをフォークし、変更を加えて、プルリクエストを送信してください。以下の貢献ガイドラインを確認してください。

Q: なぜWarpを強く推奨するのですか？

A: Warpは、他のターミナルでは不可能な機能を可能にするAPIを提供します。

• ポーリングなしでの自動出力キャプチャ
• 統合されたコマンド履歴
• 最新の非同期アーキテクチャ

🔧 技術詳細

アーキテクチャ

┌─────────────────┐         ┌──────────────────┐         ┌────────────────┐
│ Claude Desktop  │ ←────→  │ Command Runner   │ ←────→  │ Warp Terminal  │
│                 │  MCP    │ MCP Server       │ Script  │                │
│ • Send commands │         │ • Port 9876      │         │ • Execute      │
│ • Auto-retrieve │         │ • Progress Delay │         │ • Capture      │
│ • Get output    │         │ • SQLite DB      │         │ • Return       │
└─────────────────┘         └──────────────────┘         └────────────────┘

開発環境のセットアップ

git clone https://github.com/yourusername/claude-command-runner.git
cd claude-command-runner
swift package resolve
swift build

🛠️ トラブルシューティング

MCPが応答しない場合

1. サーバーが実行中か確認する：lsof -i :9876
2. Claude Desktopを再起動する
3. ./build.shで再ビルドする

コマンドがターミナルに表示されない場合

1. Warp/WarpPreviewが実行中であることを確認する
2. Claude Desktopのログでエラーを確認する
3. MCPの設定パスを確認する

自動取得が機能しない場合

1. execute_with_auto_retrieveを使用していることを確認する (execute_commandではない)
2. コマンドの出力ファイルが存在するか確認する：ls /tmp/claude_output_*.json
3. 長いコマンドの場合は、タイムアウトメッセージを待ってから手動で取得する

データベースにコマンドが記録されない場合

コマンドが実行されてもデータベースに保存されない場合は、以下の手順を試してください。

1. データベースの整合性を確認する：

   sqlite3 ~/.claude-command-runner/claude_commands.db "PRAGMA integrity_check;"
   

2. エラーや「indexから欠落」のメッセージが表示された場合、データベースが破損しています。

   # 破損したデータベースをバックアップして削除する
   mv ~/.claude-command-runner/claude_commands.db ~/.claude-command-runner/claude_commands.db.backup
   # Claude Desktopを再起動する - 新しいデータベースが自動的に作成されます
   

3. データベースが正常に動作していることを確認する：

   # コマンドが記録されているか確認する
   sqlite3 ~/.claude-command-runner/claude_commands.db "SELECT COUNT(*) FROM commands;"
   

4. 複数のサーバーインスタンスが存在するか確認する：

   ps aux | grep claude-command-runner | grep -v grep
   # 複数のインスタンスが表示された場合は、すべてを終了してClaude Desktopを再起動する
   

v3.0リリースには自動的な破損検出と回復機能が含まれていますが、問題が解決しない場合は、データベースファイルを手動で削除すると、クリーンな再作成が強制されます。

💖 このプロジェクトをサポートする

Claude Command Runnerがあなたの開発ワークフローを向上させたり、インテリジェントなコマンド実行によって時間を節約した場合、開発をサポートすることを検討してください。

あなたのサポートにより、私は以下のことができます。

• 新しい機能を追加してClaude Command Runnerを維持および改善する
• このプロジェクトをオープンソースで無料で提供し続ける
• ユーザーのリクエストとバグ修正により多くの時間を費やす
• 新しいターミナル統合とコマンドの知能化を探索する

私の仕事をサポートすることを検討してくれてありがとうございます！🙏

📄 ライセンス

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

❤️ 🍍によって作成されました

このプロジェクトが役に立った場合は、⭐を付けて、Warp Terminalを試してみてください！