gephi-mcp 1.2.0__tar.gz

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.
Files changed (14) hide show
  1. gephi_mcp-1.2.0/.gitignore +11 -0
  2. gephi_mcp-1.2.0/PKG-INFO +85 -0
  3. gephi_mcp-1.2.0/README.md +55 -0
  4. gephi_mcp-1.2.0/gephi_mcp.py +643 -0
  5. gephi_mcp-1.2.0/gephi_mcp_viewer/__init__.py +111 -0
  6. gephi_mcp-1.2.0/gephi_mcp_viewer/assets/VENDORED.md +11 -0
  7. gephi_mcp-1.2.0/gephi_mcp_viewer/assets/graphology.umd.min.js +2 -0
  8. gephi_mcp-1.2.0/gephi_mcp_viewer/assets/sigma.min.js +1369 -0
  9. gephi_mcp-1.2.0/gephi_mcp_viewer/template.html +54 -0
  10. gephi_mcp-1.2.0/pyproject.toml +68 -0
  11. gephi_mcp-1.2.0/requirements.txt +3 -0
  12. gephi_mcp-1.2.0/tests/test_tools.py +187 -0
  13. gephi_mcp-1.2.0/tests/test_viewer.py +131 -0
  14. gephi_mcp-1.2.0/uv.lock +1283 -0
gephi_mcp-1.2.0/.gitignore ADDED
@@ -0,0 +1,11 @@
1
+ gephi-mcp-plugin/target/
2
+
3
+ # Python
4
+ __pycache__/
5
+ *.pyc
6
+ *.egg-info/
7
+ .pytest_cache/
8
+ .ruff_cache/
9
+ .mypy_cache/
10
+ .venv/
11
+ mcp-server/dist/
gephi_mcp-1.2.0/PKG-INFO ADDED
@@ -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).
gephi_mcp-1.2.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).