gephi-mcp
MCP server that bridges any Model Context Protocol client to a running Gephi Desktop instance, exposing 85 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 MCP 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 MCP 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
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file gephi_mcp-1.8.0.tar.gz.
File metadata
- Download URL: gephi_mcp-1.8.0.tar.gz
- Upload date:
- Size: 180.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.13.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c1e8675b7023dd3d984a1ae37d07aa23f0d4c29e14f2fe6cbbb1f8b64746dbc3
|
|
| MD5 |
1508d5756c68706c9d7b416569b543fc
|
|
| BLAKE2b-256 |
b6ad6dc0245f21ad16db0eb4c0085db1122bfad2011952c95f0d9229ce78517d
|
File details
Details for the file gephi_mcp-1.8.0-py3-none-any.whl.
File metadata
- Download URL: gephi_mcp-1.8.0-py3-none-any.whl
- Upload date:
- Size: 188.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.13.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
12fba5dd377bacf1278394ef6bfba565be154a04c17188243dd0ac13e82ce461
|
|
| MD5 |
c6fe0971f16fce631953ec4ded177f4e
|
|
| BLAKE2b-256 |
b8764dd096c2bf5aaeeaa2efe0277de98085934e98366c0bfc8a1a6781d3d36d
|
