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.
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?
What is PuppyGraph?
PuppyGraph is a graph database that can be queried using Gremlin and Cypher.
What is MCP?
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?
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?
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?
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.