Linuxshell MCP

🚀 Linux Bash MCP Server

強力なModel Context Protocol (MCP)サーバーです。このサーバーを使用すると、Claude DesktopがWindows上の任意のWSL2 Linuxディストリビューションでbashコマンドやスクリプトを実行できます。汎用的なLinux互換性、インテリジェントなディストリビューション検出、包括的なセキュリティ対策などの特長を備えています。

🚀 クイックスタート

# 1. リポジトリをクローンする
git clone https://github.com/yourusername/linux-bash-mcp-server.git
cd linux-bash-mcp-server

# 2. 自動セットアップを実行する
npm run fix

# 3. Claude Desktopを再起動する
# 4. ClaudeでLinuxコマンドの使用を開始する！

✨ 主な機能

• 🐧 汎用的なLinuxサポート - Ubuntu、Debian、Fedora、openSUSE、Alpineなど、多くのLinuxディストリビューションで動作します。
• 🔍 スマートなディストリビューション検出 - 利用可能なWSLディストリビューションを自動的に検出し、設定します。
• 🛡️ 安全な設定マージ - セットアップ時に既存のMCPサーバーを保持します。
• 🔧 包括的な診断機能 - 組み込みのトラブルシューティングと自動修正ツールがあります。
• ⚡ 高いパフォーマンス - 設定可能なタイムアウトで最適化されたコマンド実行が可能です。
• 📊 詳細なログ記録 - トラブルシューティングと監視のためのデバッグモードがあります。
• 🔄 簡単な管理 - セットアップ、テスト、メンテナンスのためのシンプルなスクリプトが用意されています。

🛠️ 利用可能なツール

📋 前提条件

• WSL2がインストールされたWindows
• WSL2内の任意のLinuxディストリビューション (Ubuntu、Debianなど)
• Node.js 18以上
• Claude Desktopアプリ

📦 インストール

オプション1: 自動セットアップ (推奨)

git clone https://github.com/yourusername/linux-bash-mcp-server.git
cd linux-bash-mcp-server
npm run fix

オプション2: 手動セットアップ

# 依存関係をインストールする
npm install

# 対話型セットアップを実行する
npm run setup

# 機能をテストする
npm test

オプション3: クイック診断

# 問題をチェックする
npm run debug

# 設定を検証する
npm run check-config

🔧 設定

サーバーは自動的にWSLディストリビューションを検出し、設定します。手動での設定はconfig.jsonで行うことができます。

{
  "wslDistribution": "auto-detect",
  "defaultTimeout": 30000,
  "scriptTimeout": 60000,
  "maxBufferSize": 10485760,
  "debugMode": false
}

🔧 利用可能なスクリプト

🐧 サポートされているLinuxディストリビューション

• Ubuntu (最も一般的なもの)
• Debian
• Fedora
• openSUSE
• Alpine Linux
• Kali Linux
• Oracle Linux
• その他多数...

💻 使用例

設定が完了したら、Claude Desktopで以下のコマンドを使用できます。

システム管理

• "Linux環境の包括的なシステム情報を表示する"
• "ディスク使用量と空き容量を確認する"
• "CPU使用率でソートされた実行中のプロセスを一覧表示する"

ファイル操作

• "/var/logのすべてのファイルを詳細情報付きで一覧表示する"
• "過去24時間以内に変更されたファイルを検索する"
• "/homeのディレクトリサイズを表示する"

開発タスク

• "Dockerが実行中かどうかを確認する"
• "ホームディレクトリ内のリポジトリのgitステータスを表示する"
• "インストールされているPythonパッケージを一覧表示する"

自動化

• "ドキュメントのバックアップスクリプトを作成する"
• "システム監視スクリプトを生成する"
• "ログローテーションスクリプトを作成する"

🛡️ セキュリティ機能

• 設定の保存 - 既存のMCPサーバーを決して上書きしません。
• 自動バックアップ - 破損した設定のバックアップを作成します。
• 入力検証 - すべてのコマンドとパラメータを検証します。
• タイムアウト保護 - ハングするコマンドを防止します。
• エラーハンドリング - 包括的なエラー報告と回復機能があります。

🔍 トラブルシューティング

クイック修正

npm run fix        # 一般的な問題を自動解決する
npm run debug      # 詳細な診断を行う

一般的な問題

WSLが見つからない場合

wsl --install
wsl --install -d Ubuntu

依存関係が欠落している場合

npm install

設定に問題がある場合

npm run check-config
npm run setup

サーバーが起動しない場合

npm run debug

詳細な解決策については、TROUBLESHOOTING.mdを参照してください。

🤝 他のMCPサーバーとの統合

このサーバーは、以下のサーバーとシームレスに連携します。

• PowerShell MCPサーバー (Windowsコマンド)
• Memory MCPサーバー (永続的なメモ)
• File MCPサーバー (ファイル操作)
• Git MCPサーバー (バージョン管理)
• その他の任意のMCPサーバー

📚 プロジェクト構造

linux-bash-mcp-server/
├── src/
│   └── index.js              # メインのMCPサーバー
├── test/
│   └── test.js               # 包括的なテスト
├── examples/
│   ├── system_info.sh        # 例の監視スクリプト
│   └── file_operations.sh    # 例のファイル操作スクリプト
├── config.json               # サーバーの設定
├── setup.js                  # 対話型セットアップ
├── debug.js                  # 診断ツール
├── quick-fix.js             # 自動修正ユーティリティ
├── check-config.js          # 設定チェッカー
└── README.md                # このファイル

🔄 バージョン履歴

v1.0.0 (現在)

• ✅ 汎用的なLinuxディストリビューションサポート
• ✅ インテリジェントなWSLディストリビューション検出
• ✅ 安全な設定マージ
• ✅ 包括的な診断ツール
• ✅ 自動修正ユーティリティ
• ✅ 強化されたエラーハンドリング
• ✅ デバッグモードサポート

🤝 コントリビューション

コントリビューションは大歓迎です！以下の手順に従ってください。

1. リポジトリをフォークする
2. 機能ブランチを作成する
3. 変更を加える
4. 適用可能な場合はテストを追加する
5. ドキュメントを更新する
6. プルリクエストを送信する

📄 ライセンス

このプロジェクトはMITライセンスの下で提供されています。詳細については、LICENSEファイルを参照してください。

🆘 サポート

• 問題報告: GitHub Issues
• ドキュメント: Project Wiki
• ディスカッション: GitHub Discussions

🙏 謝辞

• Anthropic - Model Context Protocolの開発に感謝します。
• Microsoft - WSL2技術に感謝します。
• オープンソースコミュニティ - Linuxディストリビューションとツールに感謝します。

Claude DesktopとLinuxコミュニティのために愛情を込めて作られました

⭐ このリポジトリが役に立った場合は、スターをつけてください！