genieacs-mcp

✨ Qué obtienes

Todo se expone a través de un único endpoint JSON-RPC (/mcp). Los LLMs / Agentes pueden: initialize → readResource → listTools → callTool … y así sucesivamente.

🚀 Inicio rápido (Docker Compose)

Sigue las instrucciones de https://github.com/GeiserX/genieacs-container, está incluido en el archivo docker compose allí.

📦 Instalar vía npm (transporte stdio)

npx genieacs-mcp

O instalar globalmente:

npm install -g genieacs-mcp
genieacs-mcp

Esto descarga el binario de Go precompilado para tu plataforma y lo ejecuta con transporte stdio, compatible con cualquier cliente MCP.

🛠 Construcción local

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

🔧 Configuración

Ponlos en un archivo .env (desde .env.example) o establécelos en el entorno.

Pruebas

Probado con Inspector y actualmente funciona perfectamente. Antes de hacer un PR, asegúrate de que este servidor MCP se comporte bien a través de este medio.

Faltan pruebas con clientes MCP reales (LLMs cliente), así que por favor, envía tus PRs para mejorar las descripciones en caso de que no logre coincidir adecuadamente con los servicios ofrecidos por este servidor MCP.

Ejemplo de configuración para LLMs cliente:

{
  "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"
}

Créditos

GenieACS – el mejor ACS de código abierto

MCP-GO – implementación moderna de MCP

GoReleaser – lanzamientos multi-arquitectura sin complicaciones

Mantenedores

@GeiserX.

Contribución

¡Siéntete libre de participar! Abre un issue o envía PRs.

GenieACS-MCP sigue el Código de Conducta de Contributor Covenant.

Ecosistema GenieACS

Este proyecto es parte de un conjunto más amplio de herramientas para trabajar con GenieACS:

Otros servidores MCP de GeiserX

• cashpilot-mcp — Monitoreo de ingresos pasivos

• duplicacy-mcp — Monitoreo de salud de copias de seguridad

• lynxprompt-mcp — Planos de configuración de IA

• pumperly-mcp — Precios de combustible y carga de vehículos eléctricos

• telegram-archive-mcp — Archivo de mensajes de Telegram