Genieacs Mcp

Name: Genieacs Mcp
Author: GeiserX

@GeiserX

Repository

About Genieacs Mcp

MCP Server for GenieACS written in Go

#golang #mcp #genieacs

Basic information

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

Push 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,

Comments

More Other MCP servers

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K