PuppyGraph MCP Server

PuppyGraph MCP Server

site icon
2025.03.27 1
TypeScript图数据库查询数据查询服务数据库
PuppyGraph MCP Server 是一个为 PuppyGraph 设计的模型上下文协议(MCP)服务器,允许通过 Claude Desktop 使用 Gremlin 和 Cypher 查询图数据。它支持多种连接方式和查询语言,具有强大的回退机制和优雅的降级功能。
View on GitHub

Overview

基本能力

产品定位

PuppyGraph MCP Server 是一个为 PuppyGraph 设计的模型上下文协议(MCP)服务器,主要用于通过 Claude Desktop 或其他 MCP 兼容接口查询图数据。

核心功能

  • 支持通过 Neo4j Bolt 协议(Cypher)和 WebSocket(Gremlin)连接到 PuppyGraph 实例
  • 支持使用 Gremlin 和 Cypher 查询语言查询图数据
  • 提供从多个端点检索图结构和模式信息的功能
  • 与 Claude Desktop 和其他 MCP 兼容接口协同工作
  • 具有强大的回退机制和多种连接方法
  • 在连接失败时提供优雅的降级功能,使用示例数据

适用场景

  • 在 Claude Desktop 中查询 PuppyGraph 图数据
  • 需要同时支持 Gremlin 和 Cypher 查询语言的场景
  • 需要从多个端点获取图结构和模式信息的场景

工具列表

  • puppygraph_query: 在 PuppyGraph 上执行 Gremlin 或 Cypher 查询
  • puppygraph_schema: 获取图的模式和结构信息
  • puppygraph_status: 检查 PuppyGraph 连接状态

常见问题解答

  • 连接问题:确保远程服务器正在运行且可从网络访问
  • 防火墙问题:检查防火墙规则是否允许连接到适当的端口
  • 认证问题:验证认证凭据是否正确
  • Gremlin 连接问题:确保 WebSocket URL 以 ws://wss:// 开头

使用教程

使用依赖

  • Node.js 18+
  • 运行的 PuppyGraph 实例(或用于测试的回退模式)

安装教程

  1. 克隆仓库
  2. 安装依赖:
npm install
  1. 构建项目:
npm run build

调试方式

启动服务器:

npm start

使用环境变量:

# 连接到特定的 PuppyGraph 实例
PUPPYGRAPH_URL=bolt://your-puppygraph-server:7687 PUPPYGRAPH_USERNAME=neo4j PUPPYGRAPH_PASSWORD=your-password npm start

# 连接到 Neo4j 和 Gremlin 端点
PUPPYGRAPH_URL=bolt://your-neo4j-server:7687 PUPPYGRAPH_GREMLIN_URL=ws://your-gremlin-server:8182/gremlin npm start

连接验证

  1. 检查服务器启动日志中的连接状态
  2. 在 Claude 中使用 puppygraph_status 工具
  3. 测试简单查询:
Use the PuppyGraph tool to execute this Cypher query:
MATCH (n) RETURN count(n)

许可证

该项目遵循 Apache-2.0 开源许可条款,请参阅 Apache-2.0 了解完整条款。