Genieacs Mcp
@GeiserX
About Genieacs Mcp
MCP Server for GenieACS written in Go
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"genieacs": {
"command": "npx",
"args": [
"-y",
"genieacs-mcp"
],
"env": {
"ACS_URL": "http://localhost:7557",
"ACS_USER": "",
"ACS_PASS": ""
}
}
}
}Tools
3Push a firmware (or any file) to a device
Reboot a CPE via GenieACS
Ask the CPE to send an updated value for a single TR-069 parameter
Overview
What is Genieacs Mcp?
A tiny bridge that exposes any GenieACS instance as an MCP v1 (JSON-RPC for LLMs) server written in Go. It allows LLM agents to interact with a GenieACS TR-069 Auto-Configuration-Server (ACS) that manages CPE devices such as routers, ONTs, and gateways. The server exposes GenieACS data as resources (read‑only) and actions as tools (read/write, reboot, etc.).
How to use Genieacs Mcp?
Use the quick‑start Docker Compose file from the GenieACS‑container project or install via npm (npx genieacs-mcp). Configure via environment variables such as ACS_URL, ACS_USER, ACS_PASS, and TRANSPORT. It supports both HTTP and stdio transports; the stdio transport is recommended for local MCP clients.
Key features of Genieacs Mcp
- Exposes GenieACS data as read‑only MCP resources
- Provides tools for parameter read/write, reboot, and firmware download
- Supports preset, provision, tag, and task management
- Offers device search by criteria
- Runs as a single Go binary with minimal dependencies
- Supports HTTP and stdio transports with security headers validation
Use cases of Genieacs Mcp
- Reboot a faulty CPE device via an LLM conversation
- Query device parameters and fault information for diagnostics
- Automate preset or provision assignments across a device fleet
- Search for devices by model or status and apply tags
- Manage firmware download and task retries through natural language
FAQ from Genieacs Mcp
What dependencies does Genieacs Mcp require?
It requires a running GenieACS instance with its NBI endpoint accessible. No other runtime dependencies; the pre‑built Go binary is self‑contained.
How does Genieacs Mcp handle security?
The HTTP transport validates Host and Origin headers to prevent DNS rebinding. A Bearer token (MCP_AUTH_TOKEN) is required when listening on non‑loopback addresses. The stdio transport is unaffected and recommended for local use.
What transports does Genieacs Mcp support?
It supports HTTP (default) and stdio. Set the TRANSPORT environment variable to stdio to use the stdio transport for local MCP clients.
What is the maximum number of devices returned by a resource?
The DEVICE_LIMIT environment variable sets the maximum devices returned by the genieacs://devices/list resource, defaulting to 500.
What data does Genieacs Mcp expose as resources?
It provides resources for individual devices, files, tasks, and lists of devices, presets, provisions, and faults,
Frequently asked questions
What dependencies does Genieacs Mcp require?
It requires a running GenieACS instance with its NBI endpoint accessible. No other runtime dependencies; the pre‑built Go binary is self‑contained.
How does Genieacs Mcp handle security?
The HTTP transport validates `Host` and `Origin` headers to prevent DNS rebinding. A Bearer token (`MCP_AUTH_TOKEN`) is required when listening on non‑loopback addresses. The stdio transport is unaffected and recommended for local use.
What transports does Genieacs Mcp support?
It supports HTTP (default) and stdio. Set the `TRANSPORT` environment variable to `stdio` to use the stdio transport for local MCP clients.
What is the maximum number of devices returned by a resource?
The `DEVICE_LIMIT` environment variable sets the maximum devices returned by the `genieacs://devices/list` resource, defaulting to 500.
What data does Genieacs Mcp expose as resources?
It provides resources for individual devices, files, tasks, and lists of devices, presets, provisions, and faults,
Basic information
More Other MCP servers
Activepieces
activepiecesAI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
EverArt
modelcontextprotocolModel Context Protocol Servers
MaxKB
1Panel-dev🔥 MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。
Production-ready MCP integrations for AI applications
Klavis-AIKlavis AI: MCP integration platforms that let AI agents use tools reliably at any scale
Reactive Resume
amruthpillaiA one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!
Comments