mikrotik-mcp について
mikrotik-mcp は MikroTik RouterOS 機器向けの MCP サーバーで、SSH 経由でルーターに接続し、AI アシスタントから自然言語で管理できます。複数機器を管理するためのインベントリ機能も備え、ネットワーク管理者を想定しています。
主な機能
- 01SSH による MikroTik ルーターへの接続
- 02ファイアウォールと NAT ルールの設定
- 03ルーティング、DHCP、DNS 設定の管理
- 04WireGuard と VLAN の設定
- 05複数機器のインベントリ管理
活用シーン
- 01自然言語によるルーターのファイアウォールルール調整
- 02複数の MikroTik 機器の確認と保守
- 03AI アシスタントによる DNS や DHCP の問題調査
MCP 対応
MCP サーバーとして、AI アシスタントに MikroTik 機器の設定・管理操作を公開します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
uvx mcp-server-mikrotikMIKROTIK_HOSTIP address or hostname of the MikroTik router (single-device mode; default: 127.0.0.1). Not needed when an inventory is configured.MIKROTIK_USERNAMESSH username for the MikroTik router (single-device mode; default: admin)MIKROTIK_PASSWORDシークレットSSH password for the MikroTik router (single-device mode)MIKROTIK_PORTSSH port of the MikroTik router (single-device mode; default: 22)MIKROTIK_KEY_FILENAMEシークレットPath to SSH private key file for key-based authentication (single-device mode)MIKROTIK_READ_ONLYWhen true, expose only tools that do not modify RouterOS or its file store. Use a read-only RouterOS account as defence in depth.MIKROTIK_SENSITIVE_HIDINGWhen true, redact recognized credentials and private key material from tool results, MCP notifications, and logs, and omit tools that return opaque sensitive payloads.MIKROTIK_INVENTORY_FILEPath to a YAML file listing multiple MikroTik devices (title, host, port, username, password, key_filename, tags, region). See docs/reference/inventory.MIKROTIK_INVENTORYシークレットInline multi-device inventory as a YAML (or JSON) list; takes precedence over MIKROTIK_INVENTORY_FILE and the single-device variables. Holds credentials.ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
MikroTik MCP
概要
MikroTik MCP は、AI アシスタントと MikroTik RouterOS デバイスをつなぐブリッジを提供します。AI アシスタントは自然言語でのリクエストを通じて MikroTik ルーターとやり取りでき、VLAN の管理、ファイアウォールルールの設定、DNS 設定の処理などのコマンドを実行できます。
デモ動画
Claude Desktop
https://github.com/user-attachments/assets/24fadcdc-c6a8-48ed-90ac-74baf8f94b59
Inspector
https://github.com/user-attachments/assets/e0301ff2-8144-4503-83d0-48589d95027d
インベントリ
メモ
MikroTik MCP バージョン
0.14.0以降では、フリート構成内の複数の MikroTik デバイスを管理できます。以下の動画では、MikroTik デバイスのインベントリを使って LLM が MikroTik デバイスと通信する方法を紹介しています。
https://github.com/user-attachments/assets/185b2c39-8f55-4f26-a74c-2ac459ad38f5
ドキュメント
📚 ドキュメント全文 - 完全なガイド、API リファレンス、サンプル
🌐 オンラインでの閲覧をご希望ですか? 同じドキュメントは www.mikrotik-mcp.com (ドキュメント) でも公開されています。リポジトリを確認しながらプロジェクトを閲覧できる、ウェブに最適化された方法です。
クイックリンク
- インストールガイド - MikroTik MCP を使い始める
- テストガイド - 統合テストを実行する
- Claude Desktop との連携 - Claude Desktop 用に設定する
- MCP Inspector - インタラクティブなテストツール
- コントリビューションガイド - MikroTik MCP の改善に協力する
- 記事 - 学習用リソースとチュートリアル
- 図 - アーキテクチャと設計の図(draw.io)
貢献者 ❤️
MikroTik MCP は以下の皆さんによって構築されています。すべてのコミット、課題、 レビュー、アイデアに感謝します。
コード、バグ報告、ドキュメント、レビューなど、あらゆる形での貢献を歓迎します。 プロジェクトの前進につながります。まずは 貢献ガイドをご覧ください。
コミュニティ
質問やアイデア、相談したいことはありますか?Discord にご参加ください。 初めてルーターを接続する方も、PR に取り組んでいる方も、ユーザーと貢献者の皆さんを歓迎します。
ライセンス
この MCP サーバーは MIT License のもとでライセンスされています。MIT License の利用規約に従う限り、ソフトウェアを自由に使用、変更、配布できます。詳細については、プロジェクトリポジトリの LICENSE ファイルをご覧ください。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。
