Summary

Network analysis where the assistant checks its own map.

It goes past driving the UI: the graph is profiled before a layout runs, the result is scored for how well communities actually separated, and exports are framed around the main cloud rather than the outliers — so what comes back is a map that survives being looked at.

What it is

A three-part bridge into a running Gephi Desktop: a Java plugin that adds an HTTP API inside Gephi, a Python MCP server that translates tool calls into those HTTP calls, and a client plugin that bundles the server together with slash commands and a network-analyst agent. Edits land in the real workspace, and you can point back at it — select nodes in the Gephi window and ask what you selected.

What you get

105 tools spanning the whole workflow: project and workspace, graph construction, statistics, layout, appearance, filtering, attributes, preview and export, data laboratory, timeline, import, diagnostics and camera
Build and query — `gephi_create_project`, `gephi_import_file`, `gephi_add_nodes`, `gephi_add_edges`, `gephi_query_nodes`, `gephi_text_to_network`
Measure — `gephi_compute_modularity`, `gephi_compute_betweenness`, `gephi_compute_pagerank`, `gephi_run_statistic` for any installed metric, `gephi_whatif` for counterfactuals
Lay out and style — `gephi_run_layout`, `gephi_community_layout`, `gephi_similarity_layout`, `gephi_color_by_partition`, `gephi_size_by_ranking`, `gephi_label_clusters`
Filter and reshape — `gephi_filter_by_degree`, `gephi_extract_backbone`, `gephi_apply_filter` by name, `gephi_merge_nodes`, `gephi_detect_duplicates`
Check and export — `gephi_visual_qa` scores how well communities separated, `gephi_profile_graph` flags heavy-tailed weights and hub-and-spoke wiring before a layout runs, `gephi_export_png`, `gephi_export_gexf`, `gephi_view_graph`
`gephi_undo` — destructive operations snapshot the workspace first, so one level of undo brings the graph back

Requirements

Gephi Desktop 0.11.1 or newer, running before any tool call, with the `gephi-mcp-1.2.17.nbm` plugin installed through Tools → Plugins → Downloaded → Add Plugins and Gephi restarted; the plugin then listens on `http://127.0.0.1:8080` and `http://127.0.0.1:8080/health` should answer `{"success": true}`. The server runs through `uvx gephi-mcp` (Python 3.10+), or the Claude Code plugin bundles it. Use one connection method per app — a leftover config entry alongside the bundled install runs two servers and every tool appears twice. The plugin's HTTP API binds to `127.0.0.1` only and validates the request Host header, but it is not authenticated, so do not expose port 8080 beyond localhost. Imports GEXF, GraphML, GML, CSV, DOT and Pajek.

Setup effort

One command — uvx gephi-mcp