Name: genieacs-mcp
Author: GeiserX

✨ 提供機能

タイプ

用途

MCP URI / ツールID

リソース

GenieACSデータの読み取り専用アクセス

genieacs://device/{id}

genieacs://file/{name}

genieacs://tasks/{id}

genieacs://devices/list

ツール

GenieACS経由でのCPEアクション実行

reboot_device

download_firmware

refresh_parameter

すべて単一のJSON-RPCエンドポイント (/mcp) 経由で公開されます。 LLM / エージェントは initialize → readResource → listTools → callTool などの操作が可能です。

🚀 クイックスタート (Docker Compose)

https://github.com/GeiserX/genieacs-container の手順に従ってください。そこにDocker Composeファイルが含まれています。

📦 npm経由でのインストール (stdioトランスポート)

npx genieacs-mcp

またはグローバルにインストール:

npm install -g genieacs-mcp
genieacs-mcp

これにより、プラットフォーム用のビルド済みGoバイナリがダウンロードされ、任意のMCPクライアントと互換性のあるstdioトランスポートで実行されます。

🛠 ローカルビルド

git clone https://github.com/GeiserX/genieacs-mcp
cd genieacs-mcp

# (optional) create .env from the sample
cp .env.example .env && $EDITOR .env

go run ./cmd/server

🔧 設定

変数	デフォルト	説明
`ACS_URL`	http://localhost:7557	GenieACS NBIエンドポイント (末尾の / は不要)
`ACS_USER`	admin	GenieACSユーザー名
`ACS_PASS`	admin	GenieACSパスワード
`TRANSPORT`	(空 = HTTP)	stdioトランスポートを使用する場合は `stdio` に設定

.envファイル (.env.exampleから作成) に記述するか、環境変数として設定してください。

テスト

Inspector でテスト済みであり、現在完全に動作しています。プルリクエストを作成する前に、このMCPサーバーがこのツールを通じて適切に動作することを確認してください。

実際のMCPクライアント (クライアントLLM) でのテストが不足しているため、このMCPサーバーが提供するサービスと適切に一致しない場合は、説明を改善するためのプルリクエストを送信してください。

クライアントLLM用の設定例:

{
  "schema_version": "v1",
  "name_for_human": "GenieACS-MCP",
  "name_for_model": "genieacs_mcp",
  "description_for_human": "Read data from GenieACS and run actions on CPEs (reboot, firmware update, parameter refresh).",
  "description_for_model": "Interact with an Auto-Configuration-Server (ACS) that manages routers. First call initialize, then reuse the returned session id in header \"Mcp-Session-Id\" for every other call. Use readResource to fetch URIs that begin with genieacs://. Use listTools to discover available actions and callTool to execute them.",
  "auth": { "type": "none" },
  "api": {
    "type": "jsonrpc-mcp",
    "url":  "http://localhost:8080/mcp",
    "init_method": "initialize",
    "session_header": "Mcp-Session-Id"
  },
  "logo_url": "https://raw.githubusercontent.com/GeiserX/genieacs-container/main/extra/logo.png",
  "contact_email": "acsdesk@protonmail.com",
  "legal_info_url": "https://github.com/GeiserX/genieacs-mcp/blob/main/LICENSE"
}

クレジット

GenieACS – 最高のオープンソースACS

MCP-GO – モダンなMCP実装

GoReleaser – 手間のかからないマルチアーキテクチャリリース

メンテナー

@GeiserX。

貢献

お気軽にご参加ください！Issueを開くか、プルリクエストを送信してください。

GenieACS-MCPは Contributor Covenant 行動規範に従っています。

GenieACSエコシステム

このプロジェクトは、GenieACSを扱うための一連のツールの一部です:

プロジェクト	タイプ	説明
genieacs-docker	Docker + Helm	本番環境対応のマルチアーキテクチャDockerイメージおよびHelmチャート
genieacs-ansible	Ansible Collection	動的インベントリプラグインおよびデバイス管理モジュール
genieacs-ha	HA Integration	TR-069監視のためのHome Assistant統合
n8n-nodes-genieacs	n8n Node	GenieACSのワークフロー自動化
genieacs-services	Service Defs	Systemd/Supervisordサービス定義
genieacs-sim-docker	Simulator	テスト用のDockerベースGenieACSシミュレーター

GeiserXによるその他のMCPサーバー

cashpilot-mcp — 不労所得の監視
duplicacy-mcp — バックアップの健全性監視
lynxprompt-mcp — AI設定のブループリント
pumperly-mcp — 燃料およびEV充電価格
telegram-archive-mcp — Telegramメッセージアーカイブ

genieacs-mcp