PuppyGraph MCP Server logo

PuppyGraph MCP Server

by puppygraph

The PuppyGraph MCP Server allows Claude to query PuppyGraph instances using Gremlin and Cypher through Claude Desktop. It connects to PuppyGraph using Neo4j Bolt protocol and WebSocket.

View on GitHub

Last updated: N/A

What is PuppyGraph MCP Server?

The PuppyGraph MCP Server is a Model Context Protocol server that enables Claude (via Claude Desktop) to interact with PuppyGraph databases. It acts as a bridge, allowing Claude to execute Gremlin and Cypher queries against PuppyGraph and retrieve graph schema information.

How to use PuppyGraph MCP Server?

To use the server, you need Node.js 18+ and a running PuppyGraph instance. After cloning the repository, install dependencies with npm install, build the project with npm run build, and start the server with npm start. Configure connection details using environment variables or directly within the Claude Desktop configuration.

Key features of PuppyGraph MCP Server

  • Connects to PuppyGraph instances using Neo4j Bolt protocol and WebSocket.

  • Supports querying graph data using both Gremlin and Cypher query languages.

  • Retrieves graph structure and schema information.

  • Works with Claude Desktop and other MCP-compatible interfaces.

  • Includes robust fallback mechanisms for handling connection issues.

  • Provides graceful degradation with clear error messages when connections fail.

Use cases of PuppyGraph MCP Server

  • Enabling Claude to answer questions based on data stored in PuppyGraph.

  • Allowing Claude to perform complex graph traversals and analysis.

  • Integrating graph data into Claude's reasoning and decision-making processes.

  • Providing Claude with access to real-time graph data for dynamic interactions.

FAQ from PuppyGraph MCP Server

What is PuppyGraph?

PuppyGraph is a graph database that can be queried using Gremlin and Cypher.

What is MCP?

MCP stands for Model Context Protocol, a standard for connecting language models to external tools and data sources.

How do I configure the server to connect to my PuppyGraph instance?

You can configure the server using environment variables such as PUPPYGRAPH_URL, PUPPYGRAPH_USERNAME, and PUPPYGRAPH_PASSWORD, or by setting them directly in the Claude Desktop configuration.

What if the connection to PuppyGraph fails?

The server includes fallback mechanisms and will report clear error messages. Connection failures in one protocol won't prevent using another.

How can I verify the connection to PuppyGraph?

You can check the server startup logs, use the puppygraph_status tool in Claude, or test with a simple query.