Linuxssh MCP

🚀 Linux SSH MCP リモートコマンド実行ツール

MCP (Model Context Protocol) をベースとした Linux SSH リモート運用ツールセットです。コマンド実行、ファイル転送、ディレクトリ管理、対話型セッションなどの機能をサポートしています。

✨ 主な機能

🚀 クイックスタート

1. インストール

cd LinuxSSH_MCP
python -m venv .venv

# Windows
.\.venv\Scripts\python -m pip install -e ".[dev]"

# Linux/macOS
.venv/bin/pip install -e ".[dev]"

2. 起動

# Windows
.\.venv\Scripts\python main.py

# Linux/macOS
.venv/bin/python main.py

📚 MCP クライアント設定

Claude Desktop / Claude Code 設定

MCP 設定ファイルに以下の内容を追加してください（PATH を実際のパスに置き換えてください）：

{
  "mcpServers": {
    "linux-ssh-mcp": {
      "command": "PATH/LinuxSSH_MCP/.venv/Scripts/python.exe",
      "args": [
        "PATH/LinuxSSH_MCP/main.py"
      ]
    }
  }
}

モジュール方式の設定

{
  "mcpServers": {
    "linux-ssh-mcp": {
      "command": "PATH/LinuxSSH_MCP/.venv/Scripts/python.exe",
      "args": ["-m", "linux_ssh_mcp"]
    }
  }
}

📚 環境変数設定

環境変数を使用してデフォルト設定を上書きすることができます（接頭辞：SSH_MCP_）：

📚 MCP ツールリスト (14個)

資格情報管理

• auth_store_credentials - SSH 資格情報を keyring に保存します。

コマンド実行

• ssh_execute - 単一コマンドを実行します。
• ssh_execute_batch - バッチでコマンドを実行します。
• ssh_execute_script - Shell スクリプトを実行します。
• ssh_system_info - システム情報を取得します。
• ssh_search_content - リモートで grep 検索を行います。
• ssh_health_check - SSH 接続のヘルスチェックを行います。

キャッシュ管理

• ssh_session_info - キャッシュの状態を確認します。
• ssh_clear_cache - キャッシュをクリアします。

ファイル転送

• file_upload - ファイルをアップロードします。
• file_download - ファイルをダウンロードします。
• file_info - ファイル情報を取得します。

ディレクトリ操作

• dir_list - ディレクトリのリストを取得します（ページング）。
• dir_interactive - 対話型セッションを開始します。

📚 プロジェクト構造

LinuxSSH_MCP/
├── linux_ssh_mcp/              # コアモジュール
│   ├── __init__.py             # パッケージの初期化
│   ├── __main__.py             # モジュールのエントリーポイント
│   ├── mcp_server.py           # MCPプロトコル層、14個のツールインターフェース
│   ├── ssh_manager.py          # SSHコマンド実行のコア
│   ├── connection_pool.py      # 接続プール（バックグラウンドクリーンアップ+リクエストマージ+インデックス）
│   ├── security.py             # コマンドのセキュリティチェック（ブラックリスト/警告/ホワイトリスト）
│   ├── exceptions.py           # 6段階の構造化された異常レベル
│   ├── types.py                # TypedDict の型定義
│   ├── cache_manager.py        # TTL+LRU キャッシュ管理
│   ├── directory_manager.py    # ディレクトリ管理と対話型セッション
│   ├── file_transfer_manager.py # ファイルのアップロードとダウンロード
│   ├── auth_manager.py         # 資格情報管理(keyring)
│   ├── config_manager.py       # 設定ファイルの管理
│   ├── settings.py             # Pydantic 設定
│   ├── constants.py            # 定数の定義
│   ├── token_optimizer.py      # Token 最適化ツール
│   └── logger.py               # ログ設定(loguru)
├── tests/                      # テストケース (76個のテスト)
│   ├── test_connection_pool.py # 接続プールのテスト (34個)
│   ├── test_security.py        # セキュリティチェックのテスト (27個)
│   ├── test_exceptions.py      # 異常体系のテスト (15個)
│   ├── test_ssh_manager.py     # SSH管理のテスト
│   ├── test_auth_manager.py    # 資格情報管理のテスト
│   ├── test_cache_manager.py   # キャッシュ管理のテスト
│   └── ...                     # 他のモジュールのテスト
├── main.py                     # エントリーファイル
├── pyproject.toml              # プロジェクトの設定(ビルド/mypy/ruff/pytest)
├── requirements.txt            # 依存関係のリスト
├── .env.example                # 環境変数のサンプル
└── .gitignore                  # Git の無視ルール

📚 技術スタック

📚 開発

テストの実行

# 全てのテストを実行
.venv/Scripts/python -m pytest tests/ -v

# 特定のモジュールのテストを実行
.venv/Scripts/python -m pytest tests/test_connection_pool.py -v

# カバレッジを確認
.venv/Scripts/python -m pytest tests/ --cov=linux_ssh_mcp --cov-report=term-missing

コード品質のチェック

# 型チェック
.venv/Scripts/python -m mypy linux_ssh_mcp/

# コードスタイルのチェック
.venv/Scripts/python -m ruff check linux_ssh_mcp/

# 自動修正
.venv/Scripts/python -m ruff check --fix linux_ssh_mcp/

📄 ライセンス

MIT License