Ssh Connect MCP Server

🚀 SSH 接続 MCP サーバー

このプロジェクト内のすべてのコードは、生成 AI によって作成されています。

SSH 接続とファイル操作を行うための MCP サーバーです。

✨ 主な機能

ツール

このサーバーは、SSH 関連のいくつかのツールを実装しています。

• connect: SSH サーバーに接続します。

  • オプション引数: host、port、username、password、key_path、key_passphrase
  • 接続状態を返します。

• disconnect: SSH サーバーとの接続を切断します。

  • 引数は不要です。
  • 切断状態を返します。

• execute: SSH サーバー上でコマンドを実行します。

  • 必須引数: command（文字列）
  • オプション引数: timeout（整数、秒、デフォルト値は 60）
  • コマンド出力（stdout と stderr）と終了ステータスを返します。

• upload: ファイルを SSH サーバーにアップロードします。

  • 必須引数: local_path、remote_path
  • アップロード状態を返します。

• download: SSH サーバーからファイルをダウンロードします。

  • 必須引数: remote_path、local_path
  • ダウンロード状態を返します。

• list_files: SSH サーバー上のファイルを一覧表示します。

  • 必須引数: path
  • ファイルの種類とサイズ情報を含むファイルリストを返します。

📦 インストール

自動インストール

SSH MCP サーバーを自動インストールするための 2 つの Python スクリプトがあります。

1. Cline の場合:

./install_ssh_mcp.py

2. Claude Desktop の場合:

./install_ssh_mcp_claude.py

これらのスクリプトは以下のことを行います。

1. 設定ファイルの場所を検出します。
2. SSH 接続パラメータの入力を求めます。
3. 設定ファイル内の SSH MCP サーバーの設定を更新します。

手動インストール

Claude Desktop 上で

Claude Desktop で SSH MCP サーバーを設定する方法を示すサンプルの Claude Desktop 設定ファイル claude - desktop - config - example.json が提供されています。

Claude Desktop に SSH MCP サーバーをインストールするには、以下の手順を行います。

1. あなたの Claude Desktop 設定ファイルを見つけます。

   • macOS の場合: ~/Library/Application\ 支持/Claude/claude_desktop_config.json
   • Windows の場合: %APPDATA%/Claude/claude_desktop_config.json

2. mcpServers オブジェクトに SSH MCP サーバーの設定を追加します。

{
  "mcpServers": {
    "ssh - connect": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/ssh - connect",
        "run",
        "ssh - connect"
      ],
      "env": {
        "SSH_HOST": "example.com",
        "SSH_PORT": "22",
        "SSH_USERNAME": "username",
        "SSH_PASSWORD": "password",
        "SSH_KEY_PATH": "/path/to/private_key",
        "SSH_KEY_PASSPHRASE": "key_passphrase"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

3. 変更を適用するために Claude Desktop を再起動します。

⚠️ 重要提示

プレースホルダーの値を実際の SSH 接続情報に置き換えてください。

🔧 開発

ビルドと公開

配布パッケージを準備するには、以下の手順を行います。

1. 依存関係を同期し、ロックファイルを更新します。

uv sync

2. パッケージのリリースバージョンをビルドします。

uv build

これにより、dist/ ディレクトリにソースコードとホイールファイルが作成されます。

3. PyPI に公開します。

uv publish

⚠️ 重要提示

PyPI の認証情報を環境変数またはコマンドライン引数で設定する必要があります。

• トークン: --token または UV_PUBLISH_TOKEN
• またはユーザー名/パスワード: --username/UV_PUBLISH_USERNAME と --password/UV_PUBLISH_PASSWORD

テスト

tests ディレクトリには、SSH MCP サーバーが正常に動作するかを検証するためのテストスクリプトがあります。

python tests/test_ssh_connect.py

このテストスクリプトは、unittest とモッキングを使用して、実際に SSH サーバーに接続することなく SSH MCP サーバーの基本機能をテストします。

デバッグ

MCP サーバーは標準入出力で動作するため、デバッグは難しい場合があります。最適なデバッグ体験を得るために、MCP Inspector の使用を強くおすすめします。

以下のコマンドで MCP Inspector を起動できます。

npx @modelcontextprotocol/inspector uv --directory /path/to/ssh - connect run ssh - connect

起動後、Inspector は URL を表示し、その URL をブラウザで開いてデバッグを開始できます。