fiware-orion-mcp

MCP (Model Context Protocol) server for FIWARE Orion Context Broker. Enables LLMs like Claude to manage NGSI-v2 context entities — IoT devices, cameras, sensors, vehicles, and any real-world object modeled as a digital twin.

No official FIWARE MCP exists yet. This is the first one.

What is FIWARE Orion?

FIWARE is an open standard (ETSI NGSI-LD) for Smart City and IoT data management. The Orion Context Broker is its core component — it stores the current state of all entities and notifies subscribers when things change.

Tools available

Quick start

1. Start FIWARE stack (Docker)

cd docker
docker compose up -d
# Verify:
curl http://localhost:1026/version
curl http://localhost:8668/version

2. Install MCP server

pip install fiware-orion-mcp
# or from source:
pip install -e .

3. Configure Claude Code

Add to your ~/.claude/mcp.json or project MCP config:

{
  "mcpServers": {
    "fiware-orion": {
      "command": "python",
      "args": ["-m", "fiware_mcp.server"],
      "env": {
        "ORION_URL": "http://your-orion-host:1026",
        "QUANTUMLEAP_URL": "http://your-ql-host:8668"
      }
    }
  }
}

4. Environment variables

Example session with Claude

> List all entity types in the Context Broker
> Show me all Camera entities that are offline
> Get the full details of Camera:TIMONE-01
> Update Camera:TIMONE-01 status to "maintenance"
> Show me the uptime history of Camera:TIMONE-01 for the last 7 days

Roadmap

• NGSI-LD support (Orion-LD)
• Batch operations
• Geo-query helpers (find entities near a point)
• Export entities as GeoJSON

License

MIT — contributions welcome.