cimoxide-mcp

cimmcp is a Model Context Protocol server for ENTSO-E CGMES and Network Code RDF/XML, built on cimoxide. It lets an LLM chat answer questions about a model: which generators a model has and their set points, why an object fails validation, what a CIM class or attribute means.

Its tools are read-only:

A model set is every CIM XML file in one directory. --dir <path> (else CIMOXIDE_MODEL_DIR, else the working directory) is where relative paths resolve.

Install

With uv, nothing needs installing first; clients start it as

uvx --from cimoxide-mcp cimmcp --dir /path/to/models

or install it once with uv tool install cimoxide-mcp (or pipx install cimoxide-mcp) and run cimmcp. It is also on crates.io (cargo install cimoxide-mcp), as binaries on each GitHub release, and bundled in the VS Code extension.

Configure a client

Claude Code (servers start in the project directory, so --dir can be left out):

claude mcp add cimoxide -- uvx --from cimoxide-mcp cimmcp

Codex (~/.codex/config.toml):

[mcp_servers.cimoxide]
command = "uvx"
args = ["--from", "cimoxide-mcp", "cimmcp", "--dir", "/path/to/models"]

Claude Desktop, Cursor, Windsurf, Antigravity and most others take an mcpServers block:

{
  "mcpServers": {
    "cimoxide": {
      "command": "uvx",
      "args": ["--from", "cimoxide-mcp", "cimmcp", "--dir", "/path/to/models"]
    }
  }
}

RDFS and SHACL can be loaded at runtime instead of the built-in tables with CIMOXIDE_RDFS_DIR / CIMOXIDE_SHACL_DIR in the server's environment.