gremlin-mcp

kpritam/gremlin-mcp

3.3

If you are the rightful owner of gremlin-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

Gremlin MCP Server enables AI assistants to interact with Gremlin-compatible graph databases using natural language.

The Gremlin MCP Server is a powerful tool designed to bridge the gap between AI agents and graph databases. By leveraging the Model Context Protocol (MCP), it allows AI assistants to perform complex graph queries, discover schemas, analyze relationships, and manage data through simple conversational commands. This server is particularly useful for developers and data scientists who want to integrate AI capabilities with their graph databases, enabling more intuitive data exploration and analysis. The server supports a wide range of Gremlin-compatible databases, including Apache TinkerPop, Amazon Neptune, and JanusGraph, making it a versatile solution for various graph data needs. With features like automatic schema discovery and smart enum detection, the Gremlin MCP Server enhances the AI's ability to understand and interact with the data, providing accurate and meaningful insights.

Features

  • Natural Language Interaction: Enables AI assistants to query and manage graph databases using conversational language.
  • Automatic Schema Discovery: Automatically identifies and presents the structure of the graph database.
  • Smart Enum Detection: Detects and provides valid property values as enums for more accurate queries.
  • Comprehensive Toolset: Offers a range of tools for querying, importing, and exporting graph data.
  • Versatile Compatibility: Works with any Gremlin-compatible graph database, including Apache TinkerPop and Amazon Neptune.

Usages

usage with Claude Desktop Cursor Windsurf published package

{
  "mcpServers": {
    "gremlin": {
      "command": "npx",
      "args": ["@kpritam/gremlin-mcp"],
      "env": {
        "GREMLIN_ENDPOINT": "localhost:8182",
        "LOG_LEVEL": "info"
      }
    }
  }
}

usage with Claude Desktop Cursor Windsurf from source

{
  "mcpServers": {
    "gremlin": {
      "command": "node",
      "args": ["/path/to/gremlin-mcp/dist/server.js"],
      "env": {
        "GREMLIN_ENDPOINT": "localhost:8182",
        "LOG_LEVEL": "info"
      }
    }
  }
}

usage with authentication

{
  "mcpServers": {
    "gremlin": {
      "command": "npx",
      "args": ["@kpritam/gremlin-mcp"],
      "env": {
        "GREMLIN_ENDPOINT": "your-server.com:8182",
        "GREMLIN_USERNAME": "your-username",
        "GREMLIN_PASSWORD": "your-password",
        "GREMLIN_USE_SSL": "true"
      }
    }
  }
}

Tools

  1. get_graph_status

    Verify database connectivity and server status.

  2. get_graph_schema

    Get complete graph structure with nodes, edges, and relationships.

  3. run_gremlin_query

    Execute any Gremlin traversal query with full syntax support.

  4. refresh_schema_cache

    Force immediate refresh of cached schema information.

  5. import_graph_data

    Load data from GraphSON, CSV, or JSON with batch processing.

  6. export_subgraph

    Extract subgraphs to JSON, GraphSON, or CSV formats.