gephi_create_projectLABSCO 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 by the README's count, 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_statisticfor any installed metric,gephi_whatiffor 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_filterby name,gephi_merge_nodes,gephi_detect_duplicates - Check and export —
gephi_visual_qascores how well communities separated,gephi_profile_graphflags 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
Follow the published steps
USE CASES
01
Finding the communities in a network you just received
Import the file, compute degree and modularity, colour by the partition and size by degree, then run a force layout and export at print resolution.
02
Working out who the brokers are
Compute betweenness and PageRank, colour and size by those rankings, then query the top-ranked nodes to see who they actually are.
03
Getting a hairball to read
Profile the graph first to see whether the weights are heavy-tailed, extract the backbone or filter by degree, then lay out and score the result before exporting.
04
Asking about something you clicked on
Select nodes in the Gephi window and ask what they are — the server reads the live selection, so the question does not need node IDs.
05
Turning free text into a network
Build a word co-occurrence graph from a body of text, then treat it like any other graph for metrics, layout and export.
06
Recovering from a change that went wrong
Destructive operations snapshot the workspace automatically, so one call puts the graph back the way it was.
51 tools
Listed in project docs. Your client may show a different list.
gephi_save_projectgephi_duplicate_workspacegephi_snapshotgephi_undogephi_add_nodesgephi_add_edgesgephi_query_nodesgephi_get_nodegephi_text_to_networkgephi_compute_modularitygephi_run_statisticgephi_whatifgephi_compare_nodesgephi_run_layoutgephi_get_layout_propertiesgephi_community_layoutgephi_similarity_layoutgephi_color_by_partitiongephi_color_edges_by_partitiongephi_size_by_rankinggephi_label_clustersgephi_filter_by_degreegephi_extract_backbonegephi_list_filtersgephi_apply_filtergephi_get_columnsgephi_set_node_attributesgephi_export_pnggephi_export_screenshotgephi_export_gexfgephi_exportgephi_view_graphgephi_column_value_frequenciesgephi_detect_duplicatesgephi_merge_nodesgephi_create_regex_columngephi_get_timelinegephi_import_filegephi_import_gexfgephi_health_checkgephi_visual_qagephi_profile_graphgephi_focus_viewgephi_set_selection_modegephi_get_perspectivegephi_switch_perspectivegephi_compute_degreegephi_compute_betweennessgephi_compute_pagerankgephi_color_by_rankingBEFORE YOU INSTALL
What to know first
Tools you get
51 tools named in the project's documentation.
Requires
- Gephi Desktop 0.11.1+, running, with the gephi-mcp plugin (.nbm) installed
- uvx on PATH
Where it runs
Both documented clients run the server on your machine.
INSTALLATION
Connect your client
Server setup
Setup
Download gephi-mcp-1.2.17.nbm from the Releases page:
URL
https://github.com/MattArtzAnthro/gephi-ai/releasesIn Gephi Desktop: Tools → Plugins → Downloaded → Add Plugins — select the .nbm file, then click Install.
Restart Gephi. The plugin starts automatically and listens on http://127.0.0.1:8080 — keep Gephi running while you use the tools.
uvx
TERMINAL
uvx gephi-mcpMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"gephi-mcp": {
"command": "uvx",
"args": [
"gephi-mcp"
]
}
}
}Claude Code
CLAUDE CODE · TERMINAL
claude mcp add gephi-mcp -- uvx gephi-mcp
