Network Operator MCP

network-operator-mcp を使用すると、エージェントはデバイスの認証情報をMCPサーバー内に保持したまま、ネットワークデバイスの管理インターフェースを操作できます。

サーバーは以下のデバイスバックエンドをサポートしています：

• ssh-terminal: 対話型ネットワークCLI用の永続的なSSH PTY。

• ssh-exec: ツール呼び出しごとに1つの標準SSH execリクエスト。

• http-tplink-switch: TP-LinkスイッチのWebUI API。

• http-zte-be7200: ZTE BE7200 Pro+のWebUI API。

• http-mellanox-onyx: Mellanox OnyxのWebUI API。

サーバーはコマンド、プロンプト、APIレスポンスを解釈しません。エージェントと選択されたデバイス間でリクエストとレスポンスを転送するだけです。

テスト済みデバイス

Related MCP server: SSH MCP Server

設定

backends:
  ssh-terminal:
    connect_timeout_seconds: 15
    default_quiet_timeout_ms: 1000
    default_deadline_ms: 15000
    default_response_limit_bytes: 200000
    max_sessions: 10
    session_idle_ttl_seconds: 600
    max_session_lifetime_seconds: 3600
  ssh-exec:
    connect_timeout_seconds: 15
    default_command_timeout_seconds: 60
  http:
    connect_timeout_seconds: 10
    default_request_timeout_seconds: 30
    max_response_bytes: 2000000

accounts:
  ssh-operator:
    username: netadmin
    password: plaintext-password

  web-operator:
    username: webadmin
    password: plaintext-password

  zte-password:
    password: plaintext-password

devices:
  example-huawei:
    type: ssh-terminal
    host: 192.0.2.10
    account: ssh-operator

  example-tplink:
    type: http-tplink-switch
    host: 192.0.2.20
    account: web-operator

  example-zte:
    type: http-zte-be7200
    host: 192.0.2.30
    account: zte-password

  example-onyx:
    type: http-mellanox-onyx
    host: 192.0.2.40
    account: web-operator
    verify_tls: false

アカウントは複数のデバイスで共有できます。SSHアカウントはpassword、インラインのprivate_key、およびオプションのprivate_key_passphraseを使用できます。ZTEバックエンドは、その製品に固定のWebUIユーザー名があるため、パスワードのみのアカウントを受け入れます。

HTTPはデフォルトでポート80を使用しますが、http-mellanox-onyxはHTTPSポート443がデフォルトです。デバイスの設定がこれらのデフォルトと異なる場合は、デバイスにscheme、port、verify_tlsを設定してください。完全なプレースホルダー設定はconfig/devices.example.yamlにあります。

MCPツール

HTTPリクエスト

http_requestは、設定済みのdevice、HTTP method、およびデバイス相対のpathを受け入れます。オプションの引数はquery、headers、body、body_base64、form、timeout_secondsです。body、body_base64、formのうち最大1つだけを指定してください。

MCPサーバーは認証情報、Cookie、デバイストークンを管理します。呼び出し元は認証情報を含むヘッダーを指定できず、機密性の高い認証ヘッダーは返されません。エージェントのリクエストからのリダイレクトは自動的に追跡されず、エージェントに返されます。テキストレスポンスは直接返されます。バイナリレスポンスはbase64を使用し、body_encodingをbase64に設定します。

例：

{
  "device": "example-zte",
  "method": "POST",
  "path": "/?_type=vueData&_tag=vuecfg_data",
  "form": {
    "IF_ACTION": "Get"
  }
}

SSHターミナル

各ターミナルにはバックグラウンドリーダーがあり、デバイスの出力を一時的なトランスクリプトに追記します。最初のexchangeにinitial_output.next_cursorを引き継ぎ、その後は返された各next_cursorを前方に引き継ぎます。クワイエットタイムアウトは、その期間中に新しいバイトが到着しなかったことを意味するだけで、コマンドが完了したことを証明するものではありません。

MCPサーバーを再起動すると、アクティブなSSH接続は必ず閉じられ、そのトランスクリプトは破棄されます。デバイスに対してopen_sessionを再度呼び出し、新しい初期カーソルで続行してください。

状態

SSHターミナルはデバイス名でキー付けされ、MCPクライアントセッションが所有するものではありません。ツールはターミナルセッション識別子を公開も受け入れもしません。Streamable HTTPトランスポートもステートレスであるため、MCPサーバーを再起動しても、クライアントが古いMCPセッション識別子を保持したままになることはありません。

サーバーの実行

設定を検証します：

network-operator-mcp --config config/devices.local.yaml validate-config

stdioで実行します：

network-operator-mcp --config config/devices.local.yaml serve

Streamable HTTPで実行します：

network-operator-mcp --config config/devices.local.yaml serve \
  --transport streamable-http --host 127.0.0.1 --port 8000

サーバーはsseトランスポートもサポートしています。

セキュリティに関する注意事項

• 設定ファイルには平文の認証情報が含まれるため、保護してください。

• SSHサーバーのホストキーは検証されません。

• デバイスが信頼できる証明書を持っている場合は、TLS検証を有効にしたままにしてください。WebUI証明書を検証できないデバイスにのみverify_tls: falseを使用してください。

• MCPトランスポートは信頼できるエージェントとユーザーにのみ公開してください。HTTP API呼び出しはデバイス設定を変更できます。