
PuppyGraph MCP Server

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 实例(或用于测试的回退模式)
安装教程
- 克隆仓库
- 安装依赖:
npm install
- 构建项目:
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
连接验证
- 检查服务器启动日志中的连接状态
- 在 Claude 中使用
puppygraph_status
工具 - 测试简单查询:
Use the PuppyGraph tool to execute this Cypher query:
MATCH (n) RETURN count(n)