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로 테스트했으며 현재 완전히 작동합니다. 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.

기여

언제든 참여해 주세요! 이슈를 열거나 PR을 제출해 주세요.

GenieACS-MCP는 Contributor Covenant 행동 강령을 따릅니다.

GenieACS 생태계

이 프로젝트는 GenieACS 작업을 위한 더 넓은 도구 세트의 일부입니다:

프로젝트	유형	설명
genieacs-docker	Docker + Helm	프로덕션 준비가 완료된 멀티 아키텍처 Docker 이미지 및 Helm 차트
genieacs-ansible	Ansible 컬렉션	동적 인벤토리 플러그인 및 장치 관리 모듈
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 — 연료 및 EV 충전 가격
telegram-archive-mcp — 텔레그램 메시지 아카이브

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