MikroMCP

MikroMCP

MikroTik RouterOS と SwOS のための、AI ネイティブなネットワーク自動化。 MikroMCP は、RouterOS ルーターと SwOS スイッチを、型付けされ監査可能なModel Context Protocolサーバーとして公開します。これにより、Claude、Cursor、Codex などの MCP クライアントは、自然言語で MikroTik 機器の状態を確認、診断し、安全に操作できます。

MikroMCP は、ルーターの生の CLI アクセスが AI エージェントにとって適切な抽象化ではないために開発されました。RouterOS は強力ですが、LLM に本番ネットワーク機器へ即興でシェルコマンドを実行させるのは危険です。MikroMCP は、厳格なスキーマ、冪等な書き込み、ドライランプレビュー、ルーターごとのサーキットブレーカー、再試行ポリシー、RBAC、監査ログ、スナップショット、ロールバックを考慮した変更ワークフローを備えた、制御されたツール群をエージェントに提供します。

一言で言えば： MikroMCP は、MikroTik RouterOS を、AI インフラストラクチャ、DevOps 自動化、最新のルーター管理のための、本番運用を念頭に置いた MCP コントロールプレーンへと変えます。

---

クイックスタート

単一ルーターを stdio でデプロイする場合のセットアップは、これですべてです。スタンドアロンバイナリ、Docker、HTTP/SSE モード、RouterOS API の前提条件、15 分で完了する詳しい手順については、**スタートガイド**をご覧ください。

---

機能紹介

カテゴリ	MikroMCP が対応する内容
🧭 ルーター管理	システムの状態、時計、再起動、パッケージ、ファイル、スクリプト、スケジューラージョブ、コンテナー
🌐 ネットワーク操作	インターフェース、VLAN、IP アドレス、DHCP リース、DNS 静的レコード、ブリッジポート、WiFi クライアント
🔥 ファイアウォールとポリシー	フィルター／NAT ルール、mangle ルール、アドレスリスト、ルートテーブル、ルーティングルール
🛰️ ルーティングの可視化	静的ルート、ルーティングテーブル、BGP ピア、OSPF ネイバー
🔀 SwOS スイッチ	実験的機能です。 MikroTik SwOS および SwOS Lite スイッチ（deviceType: "swos"）に、リバースエンジニアリングされた .b HTTP API 経由で対応します。ポートリンク、PoE、SFP 診断、ファームウェア互換性チェック付きの保護された全体データの書き込み、スイッチ設定全体を 1 つの YAML ドキュメントとして扱う機能（エクスポート、ドライラン、適用）、バックアップ、ファームウェアアップグレードに対応します
🔐 安全なアクセス	HTTP ベアラー認証、bcrypt トークンハッシュ、RBAC、ルーター／ツールの制限、確認トークン
🧪 診断	ルーターから実行する ping、traceroute、torch、ログのフィルタリング、保護された SSH コマンドの実行
🛡️ 変更の安全性	ドライラン、冪等な書き込み、スナップショット、書き込みジャーナル、plan_changes、apply_plan、rollback_change
⚙️ 本番環境での動作	読み取りツールの再試行、ルーターごとのサーキットブレーカー、相関 ID、構造化ログ、監査ログ
🤖 AI エージェントとの親和性	推論、連鎖処理、自動化に使える、人が読みやすい応答と構造化 JSON コンテンツを提供します。MCP の初期化時にサーバーが instructions 文字列を通知するため、クライアントは自動で設定できます。シングルルーター構成では、MIKROMCP_DEFAULT_ROUTER を使用して routerId を解決できます。Claude Code で安全かつガイド付きのツール利用を行うための利用スキルも用意されています
🧩 MCP 互換性	デスクトップクライアント向けの stdio、リモートまたはサービス形式のクライアント向けの Streamable HTTP およびレガシー SSE

合計 132 個の型付きツールを提供します。パラメーター、デフォルト値、コピーして使えるプロンプト例を含む全カタログは、**利用可能なツール**をご覧ください。

---

デモ

使用方法

Claude によるレビュー

---

実際の利用例

ルーターの調査

Use MikroMCP to inspect core-01. Summarize system resources, RouterOS version,
running interfaces, active routes, DNS settings, and recent warning/error logs.
Flag anything that looks operationally risky.

ファイアウォールの管理

List firewall filter and NAT rules on edge-01. Identify disabled rules,
overlapping port forwards, broad accept rules, and anything without comments.
Do not change anything yet.

安全な静的ルートの変更

Dry-run a route on core-01 for 10.20.0.0/16 via 192.168.88.1 in the main table.
Show the exact planned diff and tell me whether an existing route conflicts.

WireGuard の操作

Show WireGuard peers on branch-02. Sort by last handshake age and flag peers
that have not handshaken recently or have no transfer counters.

インターフェースの診断

Check interface health on edge-01, then run ping and traceroute from the router
to 1.1.1.1. If packet loss is present, use torch on the WAN interface for a
short traffic snapshot.

計画／適用／ロールバックのワークフロー

Create a change plan that adds a DNS record and a firewall address-list entry
on edge-01. Use dry-run first, explain the plan, then wait for approval before
applying anything.

---

MikroMCP が AI エージェントに役立つ理由

MCP は、LLM がツールを呼び出すための標準的な方法を提供します。MikroMCP は、ネットワーク操作を適切に記述された、機械可読で、権限を考慮したアクションに変換することで、RouterOS を高品質な MCP 対応先にします。

AI アシスタントは MikroMCP を使用して、次のことができます。

• RouterOS のコマンド構文を暗記せずに、ルーターの状態を調査する。
• インターフェース、ルート、ファイアウォールルール、ログ、診断にまたがるツール呼び出しを連鎖させる。
• オペレーター向けの要約と、後続の推論に使える構造化 JSON の両方を返す。
• 変更を加える前にプレビューし、どのような処理が行われるかを正確に説明する。
• ツール単位の認可、ルーターのスコープ、メンテナンス時間、確認ゲートを遵守する。

---

FAQ

MikroMCP とは何ですか？

MikroMCP は、MikroTik RouterOS を 132 個の型付き監査可能なツールとして公開する、オープンソースの Model Context Protocol（MCP）サーバーです。AI アシスタントは、場当たり的に CLI コマンドを組み立てる代わりに、自然言語でルーターを調査、診断し、安全に操作できます。

MikroMCP と RouterOS API の比較

RouterOS REST/API は、生のエンドポイントを公開します。MikroMCP はそれらを、スキーマ検証、冪等性、ドライランに対応し、RBAC、監査ログ、スナップショット、ロールバックを備えたツールとして提供します。LLM が本番環境の機器に触れる前に必要な安全レイヤーです。

MikroMCP と SSH 自動化の比較

CLI 出力をスクレイピングする壊れやすい SSH スクリプトの代わりに、MikroMCP は確認ゲートとルーターごとのサーキットブレーカーを備えた、構造化された型付きの結果を返します。SSH は、REST で到達できない場合（ping とガード付きの run_command）にのみ使用します。

Claude Code で MikroMCP を使う

MikroMCP は stdio と HTTP/SSE 経由で MCP を使用するため、Claude Code と Claude Desktop から RouterOS を直接操作できます。同梱の使用スキルと組み合わせると、安全でガイド付きのワークフローを実現できます。

Codex で MikroMCP を使う

Codex は標準の MCP プロトコル経由で MikroMCP に接続します。詳しくはAI アシスタントへの接続をご覧ください。

Cursor で MikroMCP を使う

Cursor は MCP サーバー（stdio または HTTP）として MikroMCP に接続し、エディターを離れることなく MikroTik ルーターの状態確認と管理を行えます。

OpenClaw で MikroMCP を使う

OpenClaw を含む、MCP 対応のクライアントはどれでも MikroMCP を使用できます。stdio または HTTP の MCP サーバーとして設定してください。

RouterOS の AI 自動化ガイド

まずはじめにを参照してインストールと接続を行い、次に使用スキルと利用可能なツールを使って、AI アシスタントで RouterOS を安全に自動化してください。

ネットワークエンジニアにおすすめの MCP サーバー

MikroMCP は、本番環境レベルの安全機能（ドライラン、ロールバック、監査、RBAC）を備え、MikroTik／RouterOS の運用に特化しています。そのため、AI ツールを導入するネットワークエンジニアにとって、有力な MCP の選択肢です。

---

ドキュメント

README は意図的に短くしています。以下の内容はすべて、Wikiで詳しく説明しています。

リソース	用途
はじめに	インストール（npm、バイナリ、Docker）、設定、15 分で接続
RouterOS API のセットアップ	REST API の有効化、ユーザーの作成、TLS とファイアウォール
設定	ルーターの登録、認証情報、すべての環境変数
実行	実行コマンド、HTTP/SSE トランスポート、トラブルシューティング
Claude Desktop への接続	Claude Desktop への MikroMCP の登録
AI アシスタントへの接続	Claude Code、Cursor、Codex、HTTP/Docker/systemd
スキルの使用	アシスタントがツールを安全に操作できるよう、MikroMCP の利用スキルをインストール
利用可能なツール	全 132 ツール — パラメーターとプロンプトの例
アーキテクチャ	システムレイヤー、リクエストパイプライン、認証モデル
エラー処理	エラーカテゴリ、再試行エンジン、サーキットブレーカー
セキュリティ	脅威モデル、セキュリティ強化チェックリスト、脆弱性の報告
開発	プロジェクト構成、テスト、MCP Inspector ワークフロー
貢献	ツールの追加、コーディング規約、PR チェックリスト
ロードマップ · ROADMAP.md	リリース済みのマイルストーンと指針となる原則

---

貢献

課題、バグ報告、ツールのリクエスト、ドキュメントの改善、プルリクエストを歓迎します。

初めての貢献におすすめの内容：

• 対応できていない RouterOS の領域に、読み取り専用ツールを追加する。
• スクリーンショット、デモ GIF、トポロジ図を追加する。
• RouterOS の応答の正規化や冪等性に関するエッジケースのテストを拡充する。
• 実際の MikroTik デバイスおよび CHR を使い、RouterOS のバージョン互換性の検証を支援する。

開発標準：

• TypeScript の strict モード、.js 拡張子付きの ESM インポート
• .strict() を使用した Zod スキーマ、書き込みツールの冪等性と dryRun
• ドメインエラーには MikroMCPError を使用し、各ツールを対象に Vitest で重点的にテストする

大規模な変更については、範囲をメンテナーとすり合わせられるよう、事前に課題を作成してください。

謝辞

• @f0086 — SwOS / SwOS Lite スイッチのサポート（v1.9.0）。これにより、MikroMCP は初めて RouterOS の枠を超えました。
• @karamble — SwOS の完全サポート（v1.14.0）：完全な SwOS 方言、スイッチ全体への設定適用、バックアップ、ファームウェアのアップグレード、パスワード変更、スイッチに紐付いたシークレット。

---

セキュリティ

MikroMCP は実際のネットワークデバイスを制御するため、運用システムとして扱ってください。最小権限の RouterOS ユーザーを使用し、TLS（またはピン留めされたフィンガープリント）を検証し、認証情報は ~/.mikromcp/.env にのみ保存し、スコープを限定した RBAC ID を使用し、共有利用時には監査ログを記録してください。完全なセキュリティ強化チェックリストと脆弱性報告の手順は、セキュリティページをご覧ください。

---

コミュニティとサポート

• ⭐ MikroMCP が MikroTik または MCP のワークフローに役立つ場合は、リポジトリにスターを付けてください。
• 🍴 ネットワークで必要な RouterOS の機能を追加するために、フォークしてください。
• 🧵 バグ、機能リクエスト、互換性に関する情報、ドキュメントの不足については、Issue を作成してください。

---

ライセンス

MikroMCP は MIT ライセンスのもとで公開されています。