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 二进制文件，并以 stdio 传输方式运行它，兼容任何 MCP 客户端。

🛠 本地构建

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 进行测试，目前完全可用。在提交 PR 之前，请确保此 MCP 服务器通过该媒介表现良好。

缺乏与实际 MCP 客户端（客户端 LLM）的测试，因此如果它未能充分匹配此 MCP 服务器提供的服务，请提交 PR 以改进描述。

客户端 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 或提交 PR。

GenieACS-MCP 遵循 Contributor Covenant 行为准则。

GenieACS 生态系统

该项目是用于处理 GenieACS 的更广泛工具集的一部分：

项目	类型	描述
genieacs-docker	Docker + Helm	生产就绪的多架构 Docker 镜像和 Helm chart
genieacs-ansible	Ansible Collection	动态清单插件和设备管理模块
genieacs-ha	HA 集成	用于 TR-069 监控的 Home Assistant 集成
n8n-nodes-genieacs	n8n 节点	GenieACS 的工作流自动化
genieacs-services	服务定义	Systemd/Supervisord 服务定义
genieacs-sim-docker	模拟器	用于测试的基于 Docker 的 GenieACS 模拟器

GeiserX 的其他 MCP 服务器

cashpilot-mcp — 被动收入监控
duplicacy-mcp — 备份健康状况监控
lynxprompt-mcp — AI 配置蓝图
pumperly-mcp — 燃油和电动汽车充电价格
telegram-archive-mcp — Telegram 消息存档

Install Server

A

security – no known vulnerabilities

A

license - permissive license

B

quality - B tier

How are these scores calculated?

Resources

Need Help?

Related Servers

genieacs-mcp