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:
| Tool | |
|---|---|
list_model_sets |
directories holding CIM files, with each file's profiles |
summary |
a model set's files, model headers and object counts by class |
find_objects |
search by class (abstract classes included), name/mRID text and attribute value |
get_object |
one object's fields, references resolved, and what references it |
validate |
the ENTSO-E SHACL and SPARQL rules, as cimcli validate runs them |
sparql |
a SPARQL query over the merged CGMES data |
describe_class |
definitions of classes, attributes and enumerations from the ENTSO-E vocabulary |
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.
1 maintainer
Metadata
1 maintainer
Release files for cimoxide-mcp 0.5.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| cimoxide_mcp-0.5.0-py3-none-win_amd64.whl | Python 3 | none | Windows x86-64 | Details |
| cimoxide_mcp-0.5.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl | Python 3 | none | Linux glibc 2.17+ x86-64 | Details |
| cimoxide_mcp-0.5.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl | Python 3 | none | Linux glibc 2.17+ ARM64 | Details |
| cimoxide_mcp-0.5.0-py3-none-macosx_11_0_arm64.whl | Python 3 | none | macOS 11.0+ ARM64 | Details |
| cimoxide_mcp-0.5.0-py3-none-macosx_10_12_x86_64.whl | Python 3 | none | macOS 10.12+ x86-64 | Details |
Total release size: 24.3 MB
Release files / cimoxide_mcp-0.5.0-py3-none-win_amd64.whl
| Download URL | cimoxide_mcp-0.5.0-py3-none-win_amd64.whl |
|---|---|
| Size | 3.8 MB |
| Tags | Python 3 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
eb721547449d6105f703ea5b33a32e2ef123fd047d45f23a0d4e964879146128
|
|
BLAKE2b-256 checksum How to use checksums |
f13751409f478362c83420ef1060e0e3406770ebb8a9982bcb7f0e6bc2780160
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 9, 2026.
Transparency logRelease files / cimoxide_mcp-0.5.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | cimoxide_mcp-0.5.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 5.3 MB |
| Tags | Linux glibc 2.17+ x86-64 Python 3 |
|
SHA-256 checksum How to use checksums |
0872d06c8bd17b410e872f1cdbfb28e2c4f2796b95c29c62018efe81acf16bd3
|
|
BLAKE2b-256 checksum How to use checksums |
f70ecc941a54f4364bdf83796a226fbc82d0f5fb9ffe97a222c3de327450bcd7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 9, 2026.
Transparency logRelease files / cimoxide_mcp-0.5.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | cimoxide_mcp-0.5.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl |
|---|---|
| Size | 6.2 MB |
| Tags | Linux glibc 2.17+ ARM64 Python 3 |
|
SHA-256 checksum How to use checksums |
c2aea5443abf30647bf3ba7bc1009a866eec5aadf305ecb711c99500d469baf9
|
|
BLAKE2b-256 checksum How to use checksums |
d13c09321b034d9d460939ff47cb69f617a82cb3aae46c6c291094ffbd264480
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 9, 2026.
Transparency logRelease files / cimoxide_mcp-0.5.0-py3-none-macosx_11_0_arm64.whl
| Download URL | cimoxide_mcp-0.5.0-py3-none-macosx_11_0_arm64.whl |
|---|---|
| Size | 4.5 MB |
| Tags | Python 3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
89436893bfe13b8e95a05bcbe0b020f85ce63e992b9673cae1af0c957dd8acc2
|
|
BLAKE2b-256 checksum How to use checksums |
38dfb2d9cb86996ead74e31a680b2ca85f25fc4aed1f742a291dcf2ea63a52c7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 9, 2026.
Transparency logRelease files / cimoxide_mcp-0.5.0-py3-none-macosx_10_12_x86_64.whl
| Download URL | cimoxide_mcp-0.5.0-py3-none-macosx_10_12_x86_64.whl |
|---|---|
| Size | 4.6 MB |
| Tags | Python 3 macOS 10.12+ x86-64 |
|
SHA-256 checksum How to use checksums |
3d1cb94e69e3c959e2d14a680bfce12072e1b45cd64cb794c6653f111c3f8a08
|
|
BLAKE2b-256 checksum How to use checksums |
1497fa901bf9a378b29c2cc2d141fd7d8ab3b6867aa5d7a281d0d6d765cdf988
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 9, 2026.
Transparency log
