Puppygraph MCP Server

🚀 Graph MCP Server

A server that provides Model Context Protocol (MCP) services for PuppyGraph, allowing Claude to query graph databases using Gremlin and Cypher through Claude Desktop.

🚀 Quick Start

This server offers MCP services for PuppyGraph, enabling Claude to interact with graph databases via Gremlin and Cypher in Claude Desktop.

✨ Features

• Connect to multiple PuppyGraph instances using the Neo4j Bolt protocol (for Cypher) and WebSocket (for Gremlin).
• Query graph data using Gremlin and Cypher query languages.
• Retrieve graph structure and schema information from multiple endpoints.
• Include tools for verifying connection status.

📋 Prerequisites

1. Ensure the target server is running and accessible over the network.
2. Verify that firewall rules allow communication on the corresponding ports.
3. Ensure the provided authentication credentials are correct.

📦 Installation

# Install all dependencies
npm install

# Start the development server
npm start

# Build the production version
npm run build

💻 Usage Examples

Project Structure

puppy-graph-mcp/
├── src/                 # Source code directory
│   ├── main.ts         # Main program entry
│   └── services/       # External service interface implementation
├── tests/              # Test cases
└── package.json        # Project dependencies and scripts

Configuration

• Environment Variables

Tool Usage

# Query the connection status
puppygraph status

# Execute a Cypher query
puppygraph query --cypher "MATCH (n) RETURN count(n)"

# Execute a Gremlin query
puppygraph gremlin g.V().count()

📚 Documentation

Project Features

• Modular Architecture: The code is divided into modules by function, facilitating maintenance and expansion.
• Asynchronous Communication: Uses async/await for non-blocking operations.
• Error Handling: Provides detailed error logs and a retry mechanism.
• Scalability: Supports plugin extensions to add more features.

Project Status

The current version is v1.0.0, which has passed basic testing and verification.

📄 License

This project is licensed under the Apache 2.0 license.