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.
|
Binary file
|
|
@@ -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,,
|