关键词

图可视化网络分析数据探索GraphistryLLM工具

项目简介

Graphistry MCP 服务器是一个后端服务，它使得支持Model Context Protocol (MCP) 的AI助手或大型语言模型（LLM）能够利用Graphistry平台进行高级图数据可视化和分析。通过标准化的接口，LLM可以直接调用工具来上传、可视化和分析复杂的网络数据。

主要功能点

  • GPU加速图可视化: 将数据上传至Graphistry平台，利用其GPU能力快速生成交互式图可视化。
  • 图数据处理: 支持多种输入数据格式，如边列表、Pandas DataFrame 或 NetworkX 图对象。
  • 图信息查询: 获取已上传图的基本信息，如节点数和边数。
  • 图布局应用: 对可视化图应用不同的布局算法，以更好地展示数据结构。
  • 图模式检测: 执行网络分析任务，例如计算中心性、检测社区、寻找最短路径以及识别潜在的异常节点。

安装步骤

  1. 克隆仓库: 打开终端，使用 Git 克隆项目仓库： 
    git clone https://github.com/graphistry/graphistry-mcp.git
cd graphistry-mcp
  2. 创建并激活虚拟环境: 为了隔离依赖，建议使用 Python 虚拟环境。 
    python3 -m venv .venv
source .venv/bin/activate
  3. 安装依赖: 安装项目所需的库和依赖项。 
    pip install -e ".[dev]"
  4. 配置 Graphistry 账号: 在项目根目录下创建一个名为 '.env' 的文件，并填写您的 Graphistry 账号用户名和密码。您可以访问 hub.graphistry.com 注册免费账号。 
    GRAPHISTRY_USERNAME=您的Graphistry用户名
GRAPHISTRY_PASSWORD=您的Graphistry密码

服务器配置 (用于您的MCP客户端)

要让您的MCP客户端（如支持MCP的编辑器或AI助手）连接到 Graphistry MCP 服务器，您需要在客户端的MCP配置文件中添加相应的配置项。这个配置文件通常是项目根目录下的 '.mcp.json' 或客户端特定的配置文件。以下是配置时需要提供的关键信息：

  • 服务器标识 (Name): 为此服务器指定一个唯一的名称，例如 '"graphistry"'。这是客户端用来引用此服务器的名称。
  • 连接类型 (Type): 指定客户端如何与服务器通信。通常是 '"stdio"'（标准输入输出）或 '"http"'（HTTP）。对于本地运行，'"stdio"' 是常见且易于配置的方式。
  • 启动命令 (Command): 这是一个字符串，指定用于启动 Graphistry MCP 服务器进程的可执行文件路径。通常是您的虚拟环境中的 Python 解释器路径，例如 '/path/to/your/graphistry-mcp/.venv/bin/python'。确保路径正确指向您安装了依赖的虚拟环境。
  • 命令参数 (Args): 这是一个字符串数组，包含传递给启动命令的参数。至少需要指定运行服务器代码的脚本路径，例如 '["/path/to/your/graphistry-mcp/run_graphistry_mcp.py"]'。如果您配置了 HTTP 模式，可能还需要添加 '--http' 和指定的端口号，例如 '["/path/to/your/graphistry-mcp/run_graphistry_mcp.py", "--http", "8080"]'。
  • 环境变量 (Env): 这是一个 JSON 对象，允许您为启动的服务器进程设置特定的环境变量。如果您没有将 Graphistry 账号信息配置到系统环境变量或项目 '.env' 文件中，可以在这里设置 'GRAPHISTRY_USERNAME' 和 'GRAPHISTRY_PASSWORD'。但推荐使用 '.env' 文件的方式，更安全便捷。

您的 MCP 客户端配置文件中会有一个服务器列表（通常是一个 JSON 对象），您需要将 Graphistry MCP 服务器的配置作为一个条目添加到其中，键就是您指定的服务器标识。

基本使用方法

  1. 启动服务器: 确保您已激活虚拟环境，并且 Graphistry 账号已配置好。如果您的 MCP 客户端不会自动启动服务器，请手动在项目根目录启动它。推荐使用提供的启动脚本，它可以自动加载 '.env' 文件： 
    ./start-graphistry-mcp.sh
# 或直接使用 python (需手动激活虚拟环境并确保 .env 已加载)
# python run_graphistry_mcp.py
    如果客户端配置为 HTTP 模式，请指定端口启动： 
    ./start-graphistry-mcp.sh --http 8080
  2. 连接客户端: 确保您的 MCP 客户端已根据上一节说明正确配置并连接到 Graphistry MCP 服务器。
  3. 在LLM中使用: 现在，您可以在支持该 MCP 客户端的 LLM 界面中，通过与 LLM 交互的方式，描述您希望进行图可视化或分析的任务。LLM 会根据其能力和您配置的工具列表，自动调用 Graphistry MCP 服务器提供的相应工具（如 'visualize_graph'、'detect_patterns' 等）来完成任务。

信息

分类

AI与计算

访问项目