v0.1.0-alpha — Initial Release
Pre-release
The first public release of gephi-ai: AI-powered network analysis through [Gephi](https://gephi.org) and the [Model Context Protocol (MCP)](https://modelcontextprotocol.io).
This release provides a complete pipeline for building, analyzing, styling, and exporting publication-ready network visualizations by talking to your AI assistant.
What's Included
Gephi MCP Plugin
A Java NetBeans module that embeds an HTTP API server inside Gephi Desktop, exposing 73 MCP tools across 10 categories: project management, graph construction, statistics, layout, appearance, filtering, attributes, preview/export, import, and health checks.
MCP Server
A Python MCP server (built with FastMCP) that bridges any MCP-compatible AI assistant to Gephi over stdio transport. Works with Claude Code, Claude Desktop, or any other MCP client.
Claude Code Plugin
A dedicated plugin adding:
- Slash commands —
/analyze-network,/community-detection,/centrality,/visualize,/import-and-explore - Network analyst agent — a specialized subagent for structural analysis, metric comparison, and network classification
- Gephi skill — teaches Claude network science workflows, visualization best practices, and known Gephi gotchas
- Health-check hook — automatically verifies the Gephi connection before graph-modifying operations
- Reference guides — tool reference, layout guide, and statistics guide
Requirements
- Gephi Desktop 0.10.1+
- Python 3.10+
- Claude Code (for the full plugin experience) or any MCP-compatible client
Getting Started
See the [README](README.md) for installation instructions.
Architecture
Claude / AI Assistant → MCP Protocol (stdio) → MCP Server (Python) → HTTP API (localhost:8080) → Gephi Plugin (Java) → Gephi Desktop
License
Apache License 2.0