genieacs-mcp

✨ Что вы получаете

Все предоставляется через единую конечную точку 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

🔧 Конфигурация

Поместите их в файл .env (из .env.example) или установите их в окружении.

Тестирование

Протестировано с помощью Inspector и в настоящее время полностью работает. Перед созданием PR убедитесь, что этот MCP-сервер ведет себя корректно через этот инструмент.

Не хватает тестирования с реальными клиентами MCP (клиентскими LLM), поэтому, пожалуйста, присылайте свои PR для улучшения описаний, если они неадекватно соответствуют услугам, предлагаемым этим MCP-сервером.

Пример конфигурации для клиентских 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:

Другие MCP-серверы от GeiserX

• cashpilot-mcp — Мониторинг пассивного дохода

• duplicacy-mcp — Мониторинг состояния резервных копий

• lynxprompt-mcp — Чертежи конфигурации ИИ

• pumperly-mcp — Цены на топливо и зарядку электромобилей

• telegram-archive-mcp — Архив сообщений Telegram