gridoxide-mcp 0.1.0__py3-none-win_amd64.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,82 @@
1
+ Metadata-Version: 2.4
2
+ Name: gridoxide-mcp
3
+ Version: 0.1.0
4
+ Classifier: Programming Language :: Rust
5
+ Classifier: Topic :: Scientific/Engineering
6
+ Classifier: Environment :: Console
7
+ Summary: gridmcp: an MCP server that lets an LLM chat find, summarise and solve power networks (MATPOWER, UCTE-DEF, IIDM, CGMES)
8
+ Keywords: mcp,power-flow,cgmes,matpower,power-systems
9
+ License-Expression: Apache-2.0 AND BSD-3-Clause AND LGPL-2.1-or-later
10
+ Requires-Python: >=3.8
11
+ Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
12
+ Project-URL: Documentation, https://m-mirz.github.io/gridoxide/
13
+ Project-URL: Issues, https://github.com/m-mirz/gridoxide/issues
14
+ Project-URL: Repository, https://github.com/m-mirz/gridoxide
15
+
16
+ # gridoxide-mcp
17
+
18
+ `gridmcp` is a [Model Context Protocol](https://modelcontextprotocol.io) server for power
19
+ networks, built on [gridoxide](https://github.com/m-mirz/gridoxide). It lets an LLM chat answer
20
+ questions about a network: how big it is, whether it solves, which buses sit furthest from
21
+ nominal voltage and which branches carry the most.
22
+
23
+ It reads MATPOWER cases (`.m`), UCTE-DEF (`.uct`), PowSyBl IIDM (`.xiidm`) and directories of
24
+ CGMES profiles. Every tool reads; none writes a file.
25
+
26
+ | Tool | |
27
+ |---|---|
28
+ | `list_networks` | the networks below a directory, with their format |
29
+ | `summary` | size, bus types, voltage levels, tap changers, areas, and what the importer noted |
30
+ | `power_flow` | an AC power flow (Newton-Raphson), optionally with tap control, reactive limits, distributed slack or area interchange: convergence, losses, slack injection, voltage extremes, largest flows |
31
+ | `results` | the buses or branches of the last `power_flow`, filtered and sorted |
32
+
33
+ `--dir <path>` (else `GRIDOXIDE_NETWORK_DIR`, else the working directory) is where relative
34
+ paths resolve.
35
+
36
+ ## Install
37
+
38
+ With [uv](https://docs.astral.sh/uv/), nothing needs installing first; clients start it as
39
+
40
+ ```
41
+ uvx --from gridoxide-mcp gridmcp --dir /path/to/networks
42
+ ```
43
+
44
+ or install it once with `uv tool install gridoxide-mcp` (or `pipx install gridoxide-mcp`) and
45
+ run `gridmcp`. It is also on crates.io (`cargo install gridoxide-mcp`) and bundled in the
46
+ [VS Code extension](https://marketplace.visualstudio.com/items?itemName=m-mirz.gridoxide).
47
+
48
+ ## Configure a client
49
+
50
+ Claude Code (servers start in the project directory, so `--dir` can be left out):
51
+
52
+ ```
53
+ claude mcp add gridoxide -- uvx --from gridoxide-mcp gridmcp
54
+ ```
55
+
56
+ Codex (`~/.codex/config.toml`):
57
+
58
+ ```toml
59
+ [mcp_servers.gridoxide]
60
+ command = "uvx"
61
+ args = ["--from", "gridoxide-mcp", "gridmcp", "--dir", "/path/to/networks"]
62
+ ```
63
+
64
+ Claude Desktop, Cursor, Windsurf and most others take an `mcpServers` block:
65
+
66
+ ```json
67
+ {
68
+ "mcpServers": {
69
+ "gridoxide": {
70
+ "command": "uvx",
71
+ "args": ["--from", "gridoxide-mcp", "gridmcp", "--dir", "/path/to/networks"]
72
+ }
73
+ }
74
+ }
75
+ ```
76
+
77
+ ## Licence
78
+
79
+ gridmcp's own code is Apache-2.0. The binary links gridoxide, whose sparse solver is a
80
+ translation of SuiteSparse (BSD-3-Clause for AMD, LGPL-2.1-or-later for BTF/KLU); see
81
+ gridoxide's `docs/src/reference/provenance.md`.
82
+
@@ -0,0 +1,5 @@
1
+ gridoxide_mcp-0.1.0.data/scripts/gridmcp.exe,sha256=_w8yBunkWHZGGNoZFTwPzBemZiVYyemJQ9mCJPbE56w,6937600
2
+ gridoxide_mcp-0.1.0.dist-info/METADATA,sha256=C3YkGGR4EZ3GqMMn_ZydGyMSttkb81BtVKwJxO56U44,3132
3
+ gridoxide_mcp-0.1.0.dist-info/WHEEL,sha256=8Aej0W0a6Cz6apA3IzJrTnxLRVLAt-w0Oh8SA3Con_c,94
4
+ gridoxide_mcp-0.1.0.dist-info/sboms/gridoxide-mcp.cyclonedx.json,sha256=Z5Z-avQlvhpK-eOxZtcYLM0BVbAkLeF3sZkNiNOKj4o,126228
5
+ gridoxide_mcp-0.1.0.dist-info/RECORD,,
@@ -0,0 +1,4 @@
1
+ Wheel-Version: 1.0
2
+ Generator: maturin (1.15.0)
3
+ Root-Is-Purelib: false
4
+ Tag: py3-none-win_amd64