Genieacs Mcp

genieacs-mcp は、ルーター、ONT、その他の CPE デバイスを管理するオープンソースの TR-069 ACS、GenieACS 用の MCP サーバーです。Claude Desktop、Cursor、その他の MCP クライアントに追加して、自然な言葉で質問できます。昨夜、情報通知が止まったデバイスはどれか、シリアル番号 000003 のファームウェアは何か、pilot タグが付いたデバイスを再起動して、といった指示が可能です。アシスタントは GenieACS の NBI を通じて、7 個のリソースと 12 個のツールを使って情報の取得や操作を行います。独自のデータベースを持たない Go バイナリ 1 つで動作します。

機能

• 同僚に尋ねるようにデバイスを検索できます。タグ、モデル、ファームウェア、最後の情報通知、または任意の TR-069 パラメーターで検索できます（search_devices は MongoDB 形式のフィルターを受け取ります）。
• デバイスの完全なパラメーターツリー、タスク、障害に加え、ACS 上のプリセット、プロビジョニング、ファイルをリソースとして読み取れます（genieacs://device/{id}、genieacs://devices/list、...）。
• チャットからデバイスを再起動したり、ファームウェアをプッシュしたり、パラメーターを更新または設定したり、接続要求を送って起動させたりできます。
• デバイスへのタグ付け、プリセットやプロビジョニングの作成・削除、タスクの削除・再試行ができるため、アシスタントは見つけた問題を修正できます。
• 各ツールの説明には、機能、制限、例が記載されているため、クライアントはユーザーからのプロンプトなしで適切なツールを選べます。
• 読み取りと操作を区別できます。search_devices、get_parameter、7 個のリソースは読み取り専用です。その他の 10 個のツールは、デバイスにタスクをキューイングするか ACS を変更します。それぞれのツールのヒントにその内容が示されるため、操作を行うツールの実行前にクライアントから確認できます。
• 読み取り専用モード：GENIEACS_READ_ONLY=true にすると、読み取り用の 2 個のツールとリソースのみを提供します。GENIEACS_TOOLS=search_devices,reboot_device にすると、指定したツールのみを提供します。
• MCP 2026-07-28 と、2024-11-05 以降のすべてのバージョンに対応しているため、新旧両方のクライアントが stdio またはステートレス HTTP 経由で接続できます。
• ノート PC でも安全に使用できます。HTTP トランスポートは、アドレスとベアラートークンを設定しない限りループバックでのみ待ち受け、DNS リバインディング対策として Host と Origin を検証します。
• Linux、macOS、Windows の amd64 と arm64 向けの静的 Go バイナリ 1 つで動作し、npm パッケージ（npx genieacs-mcp）と Docker イメージも利用できます。

クイックスタート

このマシンからNBI（ポート7557）にアクセスできるGenieACSが必要です。まだない場合は、ファミリーのデモスタックを使うと、シミュレートされたルーターを備えたACSを約1分で利用できます。

curl -fsSLO https://raw.githubusercontent.com/GeiserX/genieacs-container/main/docker-compose.yml
docker compose --profile testing up -d      # GenieACS + MongoDB + one simulated CPE, NBI on localhost:7557

次に、mcpServers ブロックを読み込むクライアント（Claude Desktop、Cursor、Claude Code。VS Codeでは .vscode/mcp.json のキーは servers）にサーバーを追加します。

{
  "mcpServers": {
    "genieacs": {
      "command": "npx",
      "args": ["-y", "genieacs-mcp"],
      "env": { "ACS_URL": "http://localhost:7557" }
    }
  }
}

ほかのクライアントでの同じサーバーの設定：

# Claude Code
claude mcp add --transport stdio --env ACS_URL=http://localhost:7557 genieacs -- npx -y genieacs-mcp

# Docker, over stdio (any client that starts a command)
docker run -i --rm -e ACS_URL=http://host.docker.internal:7557 drumsergio/genieacs-mcp:v0.4.0

// VS Code, .vscode/mcp.json
{ "servers": { "genieacs": { "type": "stdio", "command": "npx", "args": ["-y", "genieacs-mcp"], "env": { "ACS_URL": "http://localhost:7557" } } } }

# Codex, ~/.codex/config.toml
[mcp_servers.genieacs]
command = "npx"
args = ["-y", "genieacs-mcp"]
env = { ACS_URL = "http://localhost:7557" }

「ACSが認識しているデバイスは？」と尋ね、アシスタントが 202BC1-BM632w-000000（デモスタックの場合）などのデバイスID、またはご自身のデバイスIDを答えれば、動作しています。Docker、HTTPトランスポート、ローカルビルドについては、はじめにをご覧ください。

ドキュメント

ドキュメントの全文はgeiserx.github.io/genieacs-mcpにあります。

• はじめに：npm、Docker Compose、ローカルビルド、および最初のやり取りの例
• 設定：すべての環境変数、HTTPトランスポートのセキュリティモデル、stdioおよびHTTPのクライアント設定
• 使い方：7つのリソースと12のツール、それぞれの引数、デバイスに対して操作を行う項目、プロンプトの例
• 開発：テスト、MCP Inspectorでサーバーを試す方法、コントリビューション
• 関連プロジェクト：GenieACSファミリー、その他のMCPサーバー、このサーバーの掲載先

関連プロジェクト

io.github.GeiserX/genieacs-mcp として公式MCP Registryに掲載されています。GenieACSファミリーの一員です。genieacs-container（ACS本体。DockerとHelmに対応し、このサーバーをComposeプロファイルとして利用可能）、genieacs-sim-container、genieacs-ansible、genieacs-ha、genieacs-services、n8n-nodes-genieacs（アーカイブ済み）があります。

ライセンス

GPL-3.0-or-later