convez.ai
MCP ServerDevOps & InfraestruturaAvançado
edmiand

Open5GS MCP Server

edmiand/open5gs-mcp

Gerencie núcleo 5G via agentes de IA com tools para triage, CRUD e logs

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que expõe operações do núcleo 5G (Open5GS) como ferramentas para agentes de IA. Permite gerenciar funções de rede, provisionar assinantes, diagnosticar sessões de usuário e acessar logs correlacionados sem SSH, tudo via Claude ou Ollama.

Instalação

$npx convez-ai edmiand/open5gs-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
3
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 2 semanas
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Diagnóstico e triage automatizado de sistemas 5G
  • Provisionamento e gerenciamento de assinantes (SIMs)
  • Correlação de logs entre múltiplas funções de rede
  • Monitoramento de sessões UE e PDU em tempo real
  • Automação de operações de ciclo de vida de NFs (start/stop/restart)

Veredito

Ferramenta especializada e bem estruturada para operadores de infraestrutura 5G. Coloca inteligência de IA na ponta das operações de rede; excelente para automação e diagnóstico, mas exige ambiente Open5GS configurado e conhecimento profundo de telecomunicações.

README

A tradução para o português deste README ainda está na fila.

open5gs-mcp

An MCP server that exposes Open5GS 5G core operations as tools for AI agents (Claude, Ollama, etc.).

Instead of SSH-ing into a server and grepping logs, an agent can call a single tool to triage the entire system, correlate logs across NFs, provision subscribers, or check live UE sessions.


Tools

#ToolWhat it does
1nf_lifecycleStart / stop / restart / status any NF
2system_health_snapshotOne-shot triage: all NFs + MongoDB + TUN + recent errors
3subscriber_crudFull CRUD against the subscribers MongoDB collection
4list_ue_sessionsLive UE registrations and PDU sessions from AMF + SMF
5tail_nf_logsFiltered log reads across one or more NFs, interleaved by timestamp

7 more tools planned: read_nf_config, patch_nf_config, subscriber_auth_reset, query_nf_metrics, network_infra_check, generate_credentials, nrf_registry_query


Requirements

  • Open5GS installed at ../open5gs (sibling directory)
  • Python 3.12+
  • MongoDB running (mongod.service)

Installation

git clone https://github.com/edmiand/open5gs-mcp
cd open5gs-mcp
python3 -m venv .venv
.venv/bin/pip install -r requirements.txt

Start automatically on boot

./open5gs-mcp install

This installs a systemd service that starts after network.target and mongod.service.

Start manually

./open5gs-mcp start    # runs on 0.0.0.0:8080
./open5gs-mcp status
./open5gs-mcp stop
./open5gs-mcp logs

Connecting a client

The server exposes both transports on port 8080 simultaneously — no configuration needed per client:

TransportEndpointClient
SSEhttp://<host>:8080/sseollmcp, Claude Desktop
Streamable HTTPhttp://<host>:8080/mcpmcp-curl, any HTTP client

ollmcp (Ollama)

pip install mcp-client-for-ollama

Create ~/.config/ollmcp/config.json (or use the included ollmcp-servers.json):

{
  "mcpServers": {
    "open5gs": {
      "type": "sse",
      "url": "http://<server-ip>:8080/sse"
    }
  }
}
ollmcp -m qwen3:4b -j ollmcp-servers.json

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "open5gs": {
      "command": "/path/to/open5gs-mcp/.venv/bin/python",
      "args": ["/path/to/open5gs-mcp/src/server.py"]
    }
  }
}

mcp-curl (quick tool listing)

./mcp-curl                              # list tools on localhost:8080
./mcp-curl http://192.168.1.10:8080/mcp # remote server

Example agent workflows

Triage a system in one call

system_health_snapshot()
→ overall: critical, nrf: red, amf: green, mongodb: ok
→ agent decides to call nf_lifecycle(action="start", nf=["nrf"])

Diagnose a registration failure

tail_nf_logs(nf=["amf", "ausf", "udm"], grep="imsi-999700000000001", since="15m")
→ correlated timeline across 3 NFs in one result

Provision a test SIM

subscriber_crud(operation="create", imsi="999700000000002",
    data={"security": {"k": "<Ki>", "opc": "<OPc>"}})
→ {"ok": true, "subscriber": {...}}

Check why a device can't get data

list_ue_sessions(imsi_filter="999700000000001")
→ PDU session exists but ipv4: null → IP allocation failed at SMF/UPF

Repo structure

open5gs-mcp/
├── src/
│   ├── server.py          # FastMCP server, tool registration
│   └── tools/
│       ├── nf_lifecycle.py
│       ├── system_health_snapshot.py
│       ├── subscriber_crud.py
│       ├── list_ue_sessions.py
│       └── tail_nf_logs.py
├── tests/
│   └── test_server.py     # integration tests over stdio
├── open5gs-mcp            # CLI: start / stop / restart / status / logs / install
├── open5gs-mcp.service    # systemd unit file
├── mcp-curl               # quick tool listing via HTTP
└── ollmcp-servers.json    # ready-made ollmcp server config
Ver o original no GitHub

Bom para

Relacionados