MCP Server Scrapli

🚀 MCP サーバ Scrapli

Scrapli を介してネットワーク機器と通信するための基本的な MCP（モデルコンテキストプロトコル）サーバです。

このプロジェクトは、互換性のある MCP クライアント（Claude Desktop など）が SSH を介してネットワーク機器に接続する方法を示す概念実証です。Scrapli は非同期機能を持つため、接続フレームワークとして選ばれました。

🚀 クイックスタート

📦 インストール

⚠️ 重要提示

Scrapli は Windows オペレーティングシステムと互換性がないため、この MCP サーバは Linux/MacOS でのみインストールできます。以下のガイドは Linux システム専用です。

このプロジェクトは UV をパッケージ管理に使用しています。pip を使ってインストールできます。

pip install uv

または、cURL を使ってインストールスクリプトをダウンロードすることもできます。

curl -LsSf https://astral.sh/uv/install.sh | sh

UV のインストールが完了したら、このリポジトリをクローンし、uv sync を使って依存関係をインストールします。

git clone https://git.mikelmaeso.com/mmaeso/mcp-server-scrapli.git
cd mcp-server-scrapli
uv sync

🔧 サーバの起動

仮想環境をアクティブ化します。

source .venv/bin/activate

.env.example ファイルを .env にリネームし、機器のユーザー名とパスワードを設定します。最後に、以下のコマンドでサーバを起動します。

uv run main.py

デフォルトでは、サーバは 0.0.0.0 とポート 8080 でリッスンしますが、--host と --port フラグを使ってこの動作を変更できます。

uv run main.py --host 127.0.0.1 --port 8081

🔧 Claude Desktop との連携

2025 年 4 月現在、Claude Desktop は stdio ベースの MCP サーバのみ使用できます。Windows で Claude Desktop を使用している場合、この MCP サーバに接続する唯一の方法は、MCP SSE ゲートウェイ（mcp-server-and-gw など）を使用することです。インストール手順に従い、claude_desktop_config.json ファイルに以下の設定を追加します。

{
  "mcpServers": {
    "Claude Gateway Example": {
      "command": "npx",
      "args": [
        "mcp-server-and-gw", "http://<hostname-of-mcp-server>:<port>/"
      ]
    }
  }
}