gephi-ai

MCP server that bridges any Model Context Protocol client to a running Gephi Desktop instance, exposing 113 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-ai

uvx fetches gephi-ai from PyPI on first run and caches it. For a persistent gephi-ai command on your PATH instead, use pipx install gephi-ai (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-ai command, e.g. for Claude Desktop:

{ "mcpServers": { "gephi-mcp": { "command": "uvx", "args": ["gephi-ai"] } } }

Configuration

Development

pip install -e . pytest pytest-asyncio ruff
ruff check .
pytest -q

License

Apache-2.0 — see the repository LICENSE.