gephi-mcp 1.2.0__py3-none-any.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.
- README.md +55 -0
- gephi_mcp-1.2.0.dist-info/METADATA +85 -0
- gephi_mcp-1.2.0.dist-info/RECORD +16 -0
- gephi_mcp-1.2.0.dist-info/WHEEL +4 -0
- gephi_mcp-1.2.0.dist-info/entry_points.txt +2 -0
- gephi_mcp.py +643 -0
- gephi_mcp_viewer/__init__.py +111 -0
- gephi_mcp_viewer/assets/VENDORED.md +11 -0
- gephi_mcp_viewer/assets/graphology.umd.min.js +2 -0
- gephi_mcp_viewer/assets/sigma.min.js +1369 -0
- gephi_mcp_viewer/template.html +54 -0
- pyproject.toml +68 -0
- requirements.txt +3 -0
- tests/test_tools.py +187 -0
- tests/test_viewer.py +131 -0
- uv.lock +1283 -0
README.md
ADDED
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
# gephi-mcp
|
|
2
|
+
|
|
3
|
+
MCP server that bridges any [Model Context Protocol](https://modelcontextprotocol.io) client
|
|
4
|
+
to a running [Gephi Desktop](https://gephi.org) instance, exposing **77 tools** for graph
|
|
5
|
+
construction, statistics, community detection, layout, styling, filtering, and
|
|
6
|
+
publication-ready export.
|
|
7
|
+
|
|
8
|
+
It translates MCP tool calls into HTTP requests against the Gephi MCP plugin's local API
|
|
9
|
+
(`http://127.0.0.1:8080`). Each tool has a typed signature, so clients receive a precise
|
|
10
|
+
per-field JSON schema rather than an opaque blob.
|
|
11
|
+
|
|
12
|
+
This is the **MCP server** component of [gephi-ai](https://github.com/MattArtzAnthro/gephi-ai);
|
|
13
|
+
see the top-level repository for the Gephi plugin, the Claude Code plugin, and full docs.
|
|
14
|
+
|
|
15
|
+
## Install
|
|
16
|
+
|
|
17
|
+
No install needed with [uv](https://docs.astral.sh/uv/) — point your MCP client at:
|
|
18
|
+
|
|
19
|
+
```bash
|
|
20
|
+
uvx gephi-mcp
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
`uvx` fetches [`gephi-mcp` from PyPI](https://pypi.org/project/gephi-mcp/) on first run
|
|
24
|
+
and caches it. For a persistent `gephi-mcp` command on your `PATH` instead, use
|
|
25
|
+
`pipx install gephi-mcp` (or `pipx install .` from this directory). Avoid plain
|
|
26
|
+
`pip install -e .` inside a virtual environment: the command is then only visible on
|
|
27
|
+
that venv's `PATH`, and MCP clients launched outside your shell won't find it.
|
|
28
|
+
|
|
29
|
+
## Use
|
|
30
|
+
|
|
31
|
+
The Gephi MCP plugin must be installed and Gephi Desktop running first. Then point any MCP
|
|
32
|
+
client at the `gephi-mcp` command, e.g. for Claude Desktop:
|
|
33
|
+
|
|
34
|
+
```json
|
|
35
|
+
{ "mcpServers": { "gephi-mcp": { "command": "gephi-mcp" } } }
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
## Configuration
|
|
39
|
+
|
|
40
|
+
| Env var | Default | Purpose |
|
|
41
|
+
|---|---|---|
|
|
42
|
+
| `GEPHI_API_URL` | `http://127.0.0.1:8080` | Gephi plugin HTTP API base URL |
|
|
43
|
+
| `GEPHI_REQUEST_TIMEOUT` | `60.0` | Per-request timeout (seconds) |
|
|
44
|
+
|
|
45
|
+
## Development
|
|
46
|
+
|
|
47
|
+
```bash
|
|
48
|
+
pip install -e . pytest pytest-asyncio ruff
|
|
49
|
+
ruff check .
|
|
50
|
+
pytest -q
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
## License
|
|
54
|
+
|
|
55
|
+
Apache-2.0 — see the [repository LICENSE](https://github.com/MattArtzAnthro/gephi-ai/blob/main/LICENSE).
|
|
@@ -0,0 +1,85 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: gephi-mcp
|
|
3
|
+
Version: 1.2.0
|
|
4
|
+
Summary: MCP Server for controlling Gephi Desktop via remote API
|
|
5
|
+
Project-URL: Homepage, https://www.mattartz.me
|
|
6
|
+
Project-URL: Repository, https://github.com/MattArtzAnthro/gephi-ai
|
|
7
|
+
Author: Matt Artz
|
|
8
|
+
License: Apache-2.0
|
|
9
|
+
Keywords: claude,gephi,graph,mcp,network,visualization
|
|
10
|
+
Classifier: Development Status :: 4 - Beta
|
|
11
|
+
Classifier: Intended Audience :: Science/Research
|
|
12
|
+
Classifier: License :: OSI Approved :: Apache Software License
|
|
13
|
+
Classifier: Programming Language :: Python :: 3
|
|
14
|
+
Classifier: Programming Language :: Python :: 3.10
|
|
15
|
+
Classifier: Programming Language :: Python :: 3.11
|
|
16
|
+
Classifier: Programming Language :: Python :: 3.12
|
|
17
|
+
Classifier: Programming Language :: Python :: 3.13
|
|
18
|
+
Classifier: Topic :: Scientific/Engineering :: Visualization
|
|
19
|
+
Requires-Python: >=3.10
|
|
20
|
+
Requires-Dist: defusedxml>=0.7.1
|
|
21
|
+
Requires-Dist: httpx>=0.25.0
|
|
22
|
+
Requires-Dist: mcp>=1.0.0
|
|
23
|
+
Requires-Dist: pydantic>=2.0.0
|
|
24
|
+
Provides-Extra: dev
|
|
25
|
+
Requires-Dist: mypy>=1.0.0; extra == 'dev'
|
|
26
|
+
Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
|
|
27
|
+
Requires-Dist: pytest>=7.0.0; extra == 'dev'
|
|
28
|
+
Requires-Dist: ruff>=0.1.0; extra == 'dev'
|
|
29
|
+
Description-Content-Type: text/markdown
|
|
30
|
+
|
|
31
|
+
# gephi-mcp
|
|
32
|
+
|
|
33
|
+
MCP server that bridges any [Model Context Protocol](https://modelcontextprotocol.io) client
|
|
34
|
+
to a running [Gephi Desktop](https://gephi.org) instance, exposing **77 tools** for graph
|
|
35
|
+
construction, statistics, community detection, layout, styling, filtering, and
|
|
36
|
+
publication-ready export.
|
|
37
|
+
|
|
38
|
+
It translates MCP tool calls into HTTP requests against the Gephi MCP plugin's local API
|
|
39
|
+
(`http://127.0.0.1:8080`). Each tool has a typed signature, so clients receive a precise
|
|
40
|
+
per-field JSON schema rather than an opaque blob.
|
|
41
|
+
|
|
42
|
+
This is the **MCP server** component of [gephi-ai](https://github.com/MattArtzAnthro/gephi-ai);
|
|
43
|
+
see the top-level repository for the Gephi plugin, the Claude Code plugin, and full docs.
|
|
44
|
+
|
|
45
|
+
## Install
|
|
46
|
+
|
|
47
|
+
No install needed with [uv](https://docs.astral.sh/uv/) — point your MCP client at:
|
|
48
|
+
|
|
49
|
+
```bash
|
|
50
|
+
uvx gephi-mcp
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
`uvx` fetches [`gephi-mcp` from PyPI](https://pypi.org/project/gephi-mcp/) on first run
|
|
54
|
+
and caches it. For a persistent `gephi-mcp` command on your `PATH` instead, use
|
|
55
|
+
`pipx install gephi-mcp` (or `pipx install .` from this directory). Avoid plain
|
|
56
|
+
`pip install -e .` inside a virtual environment: the command is then only visible on
|
|
57
|
+
that venv's `PATH`, and MCP clients launched outside your shell won't find it.
|
|
58
|
+
|
|
59
|
+
## Use
|
|
60
|
+
|
|
61
|
+
The Gephi MCP plugin must be installed and Gephi Desktop running first. Then point any MCP
|
|
62
|
+
client at the `gephi-mcp` command, e.g. for Claude Desktop:
|
|
63
|
+
|
|
64
|
+
```json
|
|
65
|
+
{ "mcpServers": { "gephi-mcp": { "command": "gephi-mcp" } } }
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
## Configuration
|
|
69
|
+
|
|
70
|
+
| Env var | Default | Purpose |
|
|
71
|
+
|---|---|---|
|
|
72
|
+
| `GEPHI_API_URL` | `http://127.0.0.1:8080` | Gephi plugin HTTP API base URL |
|
|
73
|
+
| `GEPHI_REQUEST_TIMEOUT` | `60.0` | Per-request timeout (seconds) |
|
|
74
|
+
|
|
75
|
+
## Development
|
|
76
|
+
|
|
77
|
+
```bash
|
|
78
|
+
pip install -e . pytest pytest-asyncio ruff
|
|
79
|
+
ruff check .
|
|
80
|
+
pytest -q
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
## License
|
|
84
|
+
|
|
85
|
+
Apache-2.0 — see the [repository LICENSE](https://github.com/MattArtzAnthro/gephi-ai/blob/main/LICENSE).
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
./README.md,sha256=T4xzhA3IIfY9QXYLmmlNbn1uDLzG2mgA4HSxr8CO9l0,1920
|
|
2
|
+
./gephi_mcp.py,sha256=7aRmVex1PMdz36KitQ6CFoRHHMoArTTR30nieeo3LZQ,31690
|
|
3
|
+
./pyproject.toml,sha256=MunOhnQsp9ue2mXrqAmcKw8yP_pVfpM4bCDB39oetLs,1606
|
|
4
|
+
./requirements.txt,sha256=3Irjw7XPa7ZV9UNxGaU4w77QXKidzLkMXkN1q9DiQPk,41
|
|
5
|
+
./uv.lock,sha256=Z1MZWp3F43-2Em5gbM4JVyyB_R-UQdDOK7DkCTBYMg8,257494
|
|
6
|
+
./gephi_mcp_viewer/__init__.py,sha256=fNCq5Cq16QTBONtuhYvCXT-gaRw8uBppbHbl9A32URU,4475
|
|
7
|
+
./gephi_mcp_viewer/template.html,sha256=6UeKkGYlf0DyaBiTKEy3cCVeHYp9ppKDYivQzsFZ_os,2371
|
|
8
|
+
./gephi_mcp_viewer/assets/VENDORED.md,sha256=4hEopFCX8pHmGxEQeuWIfP3f5eFmnxuLILX2oVp9uUY,476
|
|
9
|
+
./gephi_mcp_viewer/assets/graphology.umd.min.js,sha256=3DN--iOQP2HgZMjn5_k6Qp5oVdzPwkWIArTtMMYhwIc,73629
|
|
10
|
+
./gephi_mcp_viewer/assets/sigma.min.js,sha256=vm95DanBhWdlscQw3jsarFBDMiM2GHDtswl6mGghiog,186853
|
|
11
|
+
./tests/test_tools.py,sha256=2VfggnUyJpvEnIlRRKt8dNTr_Q6bOkdqDfvbZ_mP1v0,6663
|
|
12
|
+
./tests/test_viewer.py,sha256=FA2JZXyBcjnMcaAZZL2L0wwiVWFNzj97IcjGdbKSQxo,4957
|
|
13
|
+
gephi_mcp-1.2.0.dist-info/METADATA,sha256=GaTQo_tGeevxWCZQ7gddMyZu6fxDb_izGG0lJkYGTkk,3104
|
|
14
|
+
gephi_mcp-1.2.0.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
|
|
15
|
+
gephi_mcp-1.2.0.dist-info/entry_points.txt,sha256=RTwNG3IDJOSnL1dL8CvBTipLEOPPnZ314HXBpX9LxqM,48
|
|
16
|
+
gephi_mcp-1.2.0.dist-info/RECORD,,
|