gephi-mcp 1.2.0

MCP Server for controlling Gephi Desktop via remote API

gephi-mcp

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