mikrotik

MikroTik RouterOS API MCP サーバー

RouterOS API を使用して MikroTik ルーターとやり取りする、読み取り専用の MCP サーバー実装です。

特長

• 接続管理：MikroTik ルーターに接続し、認証します。
• リソース監視：MCP リソースを介して、インターフェース、ブリッジ、ルーティングテーブルに動的にアクセスできます。
• プロトコルのサポート：通常の TCP（8728）とセキュアな SSL/TLS（8729）の両方に対応しています。
• モダンおよびレガシーなログイン：RouterOS バージョン v6.43 より前と以降の両方に対応しています。

リソース

このサーバーは、MikroTik のエンティティを MCP リソースとして公開し、直接確認できるようにします。

• インターフェース：mikrotik://interface/{name}
  • 例：mikrotik://interface/ether1
• ブリッジ：mikrotik://bridge/{name}
  • 例：mikrotik://bridge/bridge1
• ブリッジポート：mikrotik://bridge/{bridge_name}/{interface_name}
  • 例：mikrotik://bridge/bridge1/ether2
• IP ルート：mikrotik://route/{id}
  • 例：mikrotik://route/400AF317（注：ルーティングエントリーには内部 ID が使用されます）

ツール

1. mk-connect：ルーターに接続します。
   • host：ルーターの IP アドレス。
   • user：ユーザー名。
   • password：パスワード。
   • secure：（任意）SSL/TLS を使用します。デフォルトは false です。

例： mk-connect 192.168.88.1 admin mypassword

2. mk-report：包括的なシステムレポートを生成します。

   • システムリソース、ヘルス、routerboard 情報、インターフェースのトラフィック統計（monitor-traffic を 1 回使用）を集約します。

3. mk-get：MikroTik API の /print コマンドの結果を JSON 配列で返します。

   • sentence：API パス（例：/ip/route、/interface、/log）。
   • サーバーは、パスが / で始まり、/print で終わるように自動的に調整します。

4. mk-awr：MikroTik 向けの Automatic Workload Repository（AWR）形式のレポートを生成します。

   • パフォーマンス指標、セキュリティ監査、推奨事項が含まれます。
   • 入力は不要です。

プロンプト

このサーバーは、一般的なタスク向けに事前定義されたプロンプトをいくつか提供します。

• mk-connect: MikroTik に接続：ルーターへの接続を確立するのに役立ちます。
• mk-report: システムレポート：システムの完全な状態とトラフィックレポートを要求します。
• mk-get-route: ルーティングテーブル：現在の IP ルーティングテーブルを指定して要求します。
• mk-get-interface: インターフェース一覧：設定済みのすべてのインターフェースを指定して要求します。
• mk-get-log: ログを表示：最新のシステムログエントリーを要求します。
• mk-awr: セキュリティ監査：ルーターの包括的なパフォーマンスおよびセキュリティ監査を開始します。

設定

MikroTik サーバーでは、環境変数または mk-connect ツールを使用して、認証情報を安全に管理できます。

• MK_USER：MikroTik のユーザー名（起動時にホストを指定する場合は必須）
• MK_PASSWORD：MikroTik のパスワード（起動時にホストを指定する場合は必須）

起動引数

コマンドライン引数として、ホストとセキュリティ設定を任意で指定できます。

1. host：（任意）ルーターの IP アドレス。
2. secure：（任意）SSL/TLS を使用します。デフォルトは false です。

これらを指定した場合、サーバーは起動時に MK_USER と MK_PASSWORD を使用して自動接続を試みます。

ローカルビルド

cd src/mikrotik
npm install
npm run build

Claude Desktop での使用方法

これを claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "mikrotik": {
      "command": "npx",
      "args": [
        "-y",
        "@marcelo-ochoa/server-mikrotik",
        "192.168.88.1"
      ],
      "env": {
        "MK_USER": "ai_agent",
        "MK_PASSWORD": "ai_password"
      }
    }
  }
}

Docker を使用した例：

{
  "mcpServers": {
    "mikrotik": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MK_USER=admin",
        "-e",
        "MK_PASSWORD=password",
        "mochoa/mcp-mikrotik",
        "192.168.88.1",
        "false"
      ]
    }
}

注：引数と環境変数は任意です。後から mk-connect を使用して接続できます。

デモ

mk-get の情報を使用して：

• interface
• ip/address
• ip/route
• ip/route/rules
• ip/firewall[address-list,filter,nat,mangle] 潜在的なセキュリティリスクと未使用のエンティティを見つけます

Claude Desktop、Gemini CLI、Antigravity Code Editor での使用例については、デモを参照してください。

MikroTik AWR の使用例

MikroTik ルーター向けに mk-awr ツールで生成された、パフォーマンス指標とセキュリティリスクを示す Automatic Workload Repository（AWR）形式のレポート例については、MikroTik AWR の使用例をご覧ください。

Docker

コンテナのビルド：

docker build -t mochoa/mcp-mikrotik -f src/mikrotik/Dockerfile .

コンテナの実行：

docker run -i --rm -e MK_USER=admin -e MK_PASSWORD=mypassword mochoa/mcp-mikrotik 192.168.88.1

変更履歴

変更履歴については、変更履歴をご覧ください。

ソース

いつものように、この拡張機能のコードはGitHubにあります。変更の提案や貢献を歓迎します。

📜 ライセンス

このプロジェクトは、新たな貢献部分には Apache License, Version 2.0 を、既存のコードには MIT ライセンスを適用しています。詳細については、LICENSEファイルをご覧ください。