葛菲艾
基于AI的网络分析 杰菲 和那个 模型上下文协议（MCP）通过与您的人工智能助手对话，构建、分析、设计和导出可发布的网络可视化。
专为跨网络科学和人工智能领域的研究人员而设计。
你得到了什么
73个MCP工具 用于控制Gephi Desktop——图形构建、社区检测、中心性分析、布局算法、过滤、样式和发布就绪导出。
Claude代码插件 使用斜线命令(/analyze-network, /community-detection, /centrality, /visualize, /import-and-explore)，专业的网络分析师代理，以及教授克劳德网络科学最佳实践的工作流技能。
适用于任何MCP客户端 --Claude Code、Claude Desktop或任何兼容MCP的助手。
建筑
三个组件将您的AI助手连接到Gephi Desktop：
Claude / AI Assistant
│
MCP Protocol (stdio)
│
MCP Server (Python) ← Translates MCP tool calls to HTTP
│
HTTP API (localhost:8080)
│
Gephi Plugin (Java) ← Runs inside Gephi Desktop
│
Gephi Desktop ← Must be running first| 组件 | 目录 | 功能 |
|---|---|---|
| Gephi插件 | gephi-mcp-plugin/ | 将HTTP API添加到Gephi Desktop的Java模块 |
| MCP服务器 | mcp-server/ | 通过MCP公开73个Gephi工具的Python服务器 |
| 克劳德插件 | claude-plugin/ | Claude Code的技能、命令、代理和钩子 |
这三个都必须安装。在使用任何工具之前，Gephi Desktop必须正在运行。
设置
先决条件
- Gephi桌面 0.10.1+
- Java JDK 11+ 和 梅文 （构建Gephi插件）
- Python 3.10+ （适用于MCP服务器）
步骤1：安装Gephi插件
这将在Gephi Desktop中添加HTTP API服务器。
cd gephi-mcp-plugin
mvn clean package然后在Gephi： 工具→ 插件→ 已下载→ 添加插件 --选择 target/nbm/gephi-mcp-1.0.0.nbm.
重新启动Gephi。插件会自动启动并监听 http://127.0.0.1:8080.
验证： 打开浏览器 http://127.0.0.1:8080/health --你应该看看 {"success": true}.
步骤2：安装MCP服务器
这将MCP客户端连接到Gephi HTTP API。
cd mcp-server
pip install -e .这将安装 gephi-mcp PATH上的命令。
验证： 跑 gephi-mcp --help 以确认其已安装。
步骤3：连接您的AI助手
Claude Code（完整插件——推荐）
claude plugin install gephi-ai/gephi-network-analysis这增加了MCP服务器、斜线命令、网络分析代理、技能和健康检查挂钩。
克劳德代码（仅限MCP工具）
如果你只想要73个没有技能和命令的工具：
claude mcp add gephi-mcp -- gephi-mcp克劳德桌面版
添加到MCP配置(claude_desktop_config.json):
{
"mcpServers": {
"gephi-mcp": {
"command": "gephi-mcp"
}
}
}其他MCP客户端
将您的客户指向 gephi-mcp 使用stdio传输的命令。
步骤4：验证
在Gephi跑步时，问你的助手：
“检查Gephi是否正在运行”
它应该呼叫 gephi_health_check 并确认连接。在Claude Code中，尝试：
/gephi-network-analysis:import-and-explore path/to/your/graph.gexfClaude Code插件添加了什么
插件(claude-plugin/)超越了原始MCP工具：
| 组件 | 它的作用 |
|---|---|
| 斜杠命令 | /analyze-network, /community-detection, /centrality, /visualize, /import-and-explore |
| 网络分析师代理 | 用于深度结构分析、度量比较和网络分类的专用子代理 |
| 格菲技能 | 教授Claude网络科学工作流程、可视化最佳实践和著名的Gephi陷阱 |
| 健康检查钩 | 在图修改操作之前自动验证Gephi是否正在运行 |
| 参考指南 | 工具参考、布局指南和统计解释指南 |
工具（73）
| 类别 | 计数 | 示例 |
|---|---|---|
| 项目和工作区 | 8 | gephi_create_project, gephi_save_project |
| 图形构造 | 17 | gephi_add_nodes, gephi_add_edges, gephi_query_nodes |
| 统计 | 9 | gephi_compute_modularity, gephi_compute_pagerank |
| 布局 | 6 | gephi_run_layout, gephi_get_layout_properties |
| 外观 | 9 | gephi_color_by_partition, gephi_size_by_ranking |
| 筛选 | 6 | gephi_filter_by_degree, gephi_extract_giant_component |
| 属性 | 5 | gephi_get_columns, gephi_set_node_attributes |
| 预览和导出 | 8 | gephi_export_png, gephi_export_pdf, gephi_export_gexf |
| 导入 | 4 | gephi_import_file, gephi_import_gexf |
| 健康 | 1 | gephi_health_check |
示例工作流
社区发现
1. gephi_create_project
2. gephi_import_file (your GEXF, GraphML, or CSV)
3. gephi_compute_degree
4. gephi_compute_modularity (resolution: 1.0)
5. gephi_color_by_partition (column: modularity_class)
6. gephi_size_by_ranking (column: degree)
7. gephi_run_layout (ForceAtlas 2, 1000 iterations)
8. gephi_export_png (3840x2160 for publication)中心性分析
1. Import or build graph
2. gephi_compute_betweenness
3. gephi_compute_pagerank
4. gephi_run_layout (ForceAtlas 2)
5. gephi_color_by_ranking (column: betweenesscentrality)
6. gephi_size_by_ranking (column: pageranks)
7. gephi_query_nodes (find top-ranked nodes)文档
参考指南见 claude-plugin/skills/gephi/:
- 技能.md --工作流模式、最佳实践和关键陷阱
- 参考/工具参考.md -所有73种工具的完整API参考资料
- references/layout-guide.md --布局算法选择和参数调整
- 参考文献/统计指南.md --统计解释指南
技术栈
- Gephi插件：Java 11、NetBeans平台、NanoHTTPD、Gson
- MCP 服务器：Python 3.10+，MCP SDK（FastMCP），httpx，Pydantic
- 目标：Gephi 0.10.1，NetBeans发布126
归因
如果您在工作中使用或改编此项目，请注明：
与格菲艾（Matt Artz，2025-2026）一起建造https://github.com/MattArtzAnthro/gephi-ai
许可证
Apache许可证2.0——请参阅 许可证.
作者
马特·阿尔茨 — mattartz.me | ORCID