gephi-mcp
MCP server that bridges any Model Context Protocol client to a running Gephi Desktop instance, exposing 112 tools for graph construction, statistics, community detection, layout, styling, filtering, and publication-ready export.
It translates MCP tool calls into HTTP requests against the Gephi AI plugin's local API
(http://127.0.0.1:8080). Each tool has a typed signature, so clients receive a precise
per-field JSON schema rather than an opaque blob.
This is the MCP server component of gephi-ai; see the top-level repository for the Gephi plugin, the Claude Code plugin, and full docs.
Install
No install needed with uv — point your MCP client at:
uvx gephi-mcp
uvx fetches gephi-mcp from PyPI on first run
and caches it. For a persistent gephi-mcp command on your PATH instead, use
pipx install gephi-mcp (or pipx install . from this directory). Avoid plain
pip install -e . inside a virtual environment: the command is then only visible on
that venv's PATH, and MCP clients launched outside your shell won't find it.
Use
The Gephi AI plugin must be installed and Gephi Desktop running first. Then point any MCP
client at the gephi-mcp command, e.g. for Claude Desktop:
{ "mcpServers": { "gephi-mcp": { "command": "uvx", "args": ["gephi-mcp"] } } }
Configuration
| Env var | Default | Purpose |
|---|---|---|
GEPHI_API_URL |
http://127.0.0.1:8080 |
Gephi plugin HTTP API base URL |
GEPHI_REQUEST_TIMEOUT |
60.0 |
Per-request timeout (seconds) |
Development
pip install -e . pytest pytest-asyncio ruff
ruff check .
pytest -q
License
Apache-2.0 — see the repository LICENSE.
1 maintainer
Metadata
1 maintainer
Release files for gephi-mcp 1.17.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| gephi_mcp-1.17.0.tar.gz | 345.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| gephi_mcp-1.17.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 719.0 kB
Release files / gephi_mcp-1.17.0.tar.gz
| Download URL | gephi_mcp-1.17.0.tar.gz |
|---|---|
| Size | 345.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
9fcb252d74fc3c2cb8282846caf136c8fe360f029a0ab60d72b83b0620e121c2
|
|
BLAKE2b-256 checksum How to use checksums |
bce3cc100c7f43c4b4cc110aa3b9fe3a93e811c74913811d3530fd98002f55d2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.5
|
Release files / gephi_mcp-1.17.0-py3-none-any.whl
| Download URL | gephi_mcp-1.17.0-py3-none-any.whl |
|---|---|
| Size | 373.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
6067f30647cd48f25220c047e8b8de8c6bee3bdd9d1d194c011041d109b06778
|
|
BLAKE2b-256 checksum How to use checksums |
fc3ae34e1fe7655afce99ebc42a78e969dd5d5c2857c7b1dfdbe2a8b79741dde
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.5
|
