PuppyGraph MCP Server

What is PuppyGraph MCP Server?

The PuppyGraph MCP Server is a Model Context Protocol server for PuppyGraph that enables querying graph data using Gremlin and Cypher through Claude Desktop and other MCP-compatible interfaces.

How to use PuppyGraph MCP Server?

Install dependencies with npm install, build with npm run build, then start the server with npm start. Configure connection via environment variables such as PUPPYGRAPH_URL, PUPPYGRAPH_USERNAME, and PUPPYGRAPH_PASSWORD, or set them directly in the Claude Desktop MCP configuration file.

Key features of PuppyGraph MCP Server

• Connect via Neo4j Bolt (Cypher) and WebSocket (Gremlin)
• Query graph data with both Gremlin and Cypher
• Retrieve graph schema and structure information
• Works with Claude Desktop and other MCP interfaces
• Robust fallback mechanisms across multiple protocols
• Clear error messages when connections fail

Use cases of PuppyGraph MCP Server

• Query a PuppyGraph instance using natural language via Claude Desktop
• Explore graph schema and structure without writing direct queries
• Check PuppyGraph connection status and verify endpoints
• Execute both Gremlin and Cypher queries from a single interface
• Perform graph analytics tasks through conversational AI

FAQ from PuppyGraph MCP Server

What query languages does it support?

It supports both Gremlin and Cypher query languages.

What are the prerequisites?

Node.js 18+ and a running PuppyGraph instance are required.

How do I configure connection details?

Set environment variables like PUPPYGRAPH_URL, PUPPYGRAPH_USERNAME, and PUPPYGRAPH_PASSWORD, or specify them in the env section of the Claude Desktop MCP config.

What happens if one connection method fails?

Connection failures in one protocol (e.g., Neo4j) won't prevent using another (e.g., Gremlin); the server will report clear errors for the failed method.

How can I verify connectivity?

Use the puppygraph_status tool in Claude to check connection status at any time.