puppygraph-mcp-server

puppygraph-mcp-server

2
databases

The PuppyGraph MCP Server is a Model Context Protocol server designed to facilitate graph querying using Gremlin and Cypher languages. It supports connectivity with PuppyGraph instances and provides robust fallback mechanisms for handling connection issues. Key features include Neo4j and WebSocket integrations, along with comprehensive testing suites.

PuppyGraph MCP Server

Model Context Protocol (MCP) server for PuppyGraph, enabling Claude to query graphs using Gremlin and Cypher. Provides robust connectivity and graceful degradation with sample data when connections fail. Features include connectivity to PuppyGraph instances via Neo4j Bolt and WebSocket, as well as querying graph data and structure retrieval.

Features

  • Connect using Neo4j Bolt and WebSocket
  • Query graph data via Gremlin and Cypher
  • Retrieve graph structure and schema
  • Robust fallback mechanisms

Prerequisites

  • Node.js 18+
  • Running PuppyGraph instance or fallback mode

Installation

  1. Clone repository
  2. Install dependencies
  3. Build the project

Usage

Start the server and configure environment variables for connections to Neo4j and Gremlin endpoints.

Testing

Includes unit and integration tests following best practices, ensuring compliance with the Model Context Protocol.

Available Tools

  • puppygraph_query
  • puppygraph_schema
  • puppygraph_status