Ssh Client MCP

🚀 SSH/SFTP MCP Server

このSSH/SFTP MCPサーバーは、ClaudeのようなAIアシスタントがリモートサーバーでSSHコマンドを実行し、SFTPファイル操作を行うことを可能にするModel Context Protocol (MCP)サーバーです。

🚀 クイックスタート

Claude Desktopの設定

Claude Desktopの設定ファイルに以下を追加します。

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

オプション1: CLI引数 (推奨)

コマンドライン引数を使用してサーバーを直接設定します。

{
  "mcpServers": {
    "ssh": {
      "command": "npx",
      "args": [
        "ssh-client-mcp",
        "--host", "192.168.1.100",
        "--user", "admin",
        "--password", "your-password"
      ]
    }
  }
}

秘密鍵認証を使用する場合:

{
  "mcpServers": {
    "ssh": {
      "command": "npx",
      "args": [
        "ssh-client-mcp",
        "--host", "192.168.1.100",
        "--user", "admin",
        "--key", "~/.ssh/id_rsa"
      ]
    }
  }
}

秘密鍵とパスフレーズを使用する場合:

{
  "mcpServers": {
    "ssh": {
      "command": "npx",
      "args": [
        "ssh-client-mcp",
        "--host", "192.168.1.100",
        "--user", "admin",
        "--key", "~/.ssh/id_rsa",
        "--passphrase", "your-key-passphrase"
      ]
    }
  }
}

利用可能なCLI引数:

オプション2: 設定ファイル

作業ディレクトリにservers.jsonファイルを作成します。

{
  "servers": [
    {
      "id": "my-server",
      "name": "My Server",
      "host": "192.168.1.100",
      "port": 22,
      "username": "admin",
      "password": "your-password"
    }
  ],
  "defaultServer": "my-server"
}

オプション3: 環境変数

SSH_SERVER_DEV_HOST=192.168.1.100
SSH_SERVER_DEV_PORT=22
SSH_SERVER_DEV_USERNAME=admin
SSH_SERVER_DEV_PASSWORD=your-password
SSH_SERVER_DEV_NAME=Development Server

その後、Claude Desktopを再起動してMCPサーバーを読み込みます。

✨ 主な機能

• サーバー構成管理 - 設定ファイルまたは環境変数でサーバーを定義します。
• 接続テスト - セッションを確立する前にサーバーの接続性をテストします。
• SSHコマンド実行 - 必要に応じてsudoサポート付きでリモートでコマンドを実行します。
• SFTPファイル操作 - ファイル/ディレクトリのアップロード、ダウンロード、一覧表示、作成、削除を行います。
• セッション管理 - アイドルセッションの自動クリーンアップ、接続プーリングを行います。
• 複数の認証方法 - パスワードと秘密鍵認証をサポートします。

📦 インストール

npxを使用する (推奨)

npx ssh-client-mcp

npmを使用する

npm install -g ssh-client-mcp

ソースから

git clone https://github.com/veithly/ssh-client-mcp.git
cd ssh-client-mcp
npm install
npm run build

💻 使用例

🔍 設定済みサーバーの一覧表示

Tool: ssh_list_servers
Arguments: {}

🔌 接続テスト

Tool: ssh_test_connection
Arguments: {
  "serverId": "my-server"
}

🖥️ サーバーへの接続

Tool: ssh_connect_by_id
Arguments: {
  "serverId": "my-server"
}

🚀 コマンドの実行

Tool: ssh_exec
Arguments: {
  "sessionId": "<session-id>",
  "command": "ls -la /home"
}

📤 ファイルのアップロード

Tool: sftp_upload
Arguments: {
  "sessionId": "<session-id>",
  "localPath": "/local/path/file.txt",
  "remotePath": "/remote/path/file.txt"
}

📥 ファイルのダウンロード

Tool: sftp_download
Arguments: {
  "sessionId": "<session-id>",
  "remotePath": "/remote/path/file.txt",
  "localPath": "/local/path/file.txt"
}

📚 ドキュメント

利用可能なツール (合計18個)

サーバー管理

接続管理

コマンド実行

ファイル操作 (SFTP)

設定オプション

環境変数

サーバー設定フィールド

*passwordまたはprivateKeyPathのいずれかを指定する必要があります。

🔧 技術詳細

開発

# リポジトリをクローンする
git clone https://github.com/veithly/ssh-client-mcp.git
cd ssh-client-mcp

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

# ビルドする
npm run build

# ウォッチモードで実行する
npm run dev

# ビルドをクリーンする
npm run clean

プロジェクト構造

ssh-client-mcp/
├── src/
│   ├── index.ts              # MCPサーバーのエントリーポイント
│   ├── types.ts              # 型定義
│   ├── SessionManager.ts     # SSHセッションのライフサイクル管理
│   ├── SSHExecutor.ts        # コマンド実行
│   ├── SFTPOperations.ts     # SFTPファイル操作
│   ├── ConnectionTester.ts   # 接続テスト
│   ├── config/
│   │   ├── ConfigManager.ts  # 設定管理
│   │   ├── types.ts          # 設定型定義
│   │   └── index.ts          # 設定エクスポート
│   └── tools/
│       ├── connection.ts     # 接続ツール
│       ├── command.ts        # コマンドツール
│       ├── file.ts           # ファイルツール
│       ├── server.ts         # サーバー管理ツール
│       └── index.ts          # ツールエクスポート
├── servers.example.json      # サーバー設定の例
├── .env.example              # 環境設定の例
├── package.json
├── tsconfig.json
└── README.md

📄 ライセンス

MIT © 2024

謝辞

• Model Context Protocol - MCP SDK
• ssh2 - Node.js用のSSH2クライアントライブラリ

Claude AI用に作成されました。