Open5GS MCP Server
edmiand/open5gs-mcp
Gerencie núcleo 5G via agentes de IA com tools para triage, CRUD e logs
Ver no GitHubServidor 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-mcp1 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
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
| # | Tool | What it does |
|---|---|---|
| 1 | nf_lifecycle | Start / stop / restart / status any NF |
| 2 | system_health_snapshot | One-shot triage: all NFs + MongoDB + TUN + recent errors |
| 3 | subscriber_crud | Full CRUD against the subscribers MongoDB collection |
| 4 | list_ue_sessions | Live UE registrations and PDU sessions from AMF + SMF |
| 5 | tail_nf_logs | Filtered 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:
| Transport | Endpoint | Client |
|---|---|---|
| SSE | http://<host>:8080/sse | ollmcp, Claude Desktop |
| Streamable HTTP | http://<host>:8080/mcp | mcp-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