
kpritam/gremlin-mcp
Developer toolsЭта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал
MCP server for Gremlin graph databases - Connect AI agents like Claude to TinkerPop, Neptune & more. Natural language graph queries & analysis.
Обзор
An MCP (Model Context Protocol) server that enables AI assistants to interact with any Gremlin-compatible graph database through natural language. Query your data, discover schemas, analyze relationships, and manage graph data using simple conversations. - 🔍 - Automatic schema discovery - 📊 - Complex graph queries - 🔗 - Relationship analysis - 📈 - Data insights - 📥 - Data loading - 📤 - Data extraction - 🧠 - AI learns your data's valid values automatically Your AI assistant gets access to these powerful tools: Add this to your MCP client configuration: Make sure your Gremlin-compatible database is running: "Can you check if my graph database is connected and show me its schema?" "What's the structure of my graph database?" The AI calls get_graph_schema and tells you about your node types, edge types, and how they're connected.
README
Показан фрагмент оригинального README. Открыть оригинал.
Gremlin MCP Server
Connect AI agents like Claude, Cursor, and Windsurf to your graph databases!
An MCP (Model Context Protocol) server that enables AI assistants to interact with any Gremlin-compatible graph database through natural language. Query your data, discover schemas, analyze relationships, and manage graph data using simple conversations.
✨ What You Can Do
Talk to your graph database naturally:
- 🔍 “What’s the structure of my graph?” - Automatic schema discovery
- 📊 “Show me all users over 30 and their connections” - Complex graph queries
- 🔗 “Find the shortest path between Alice and Bob” - Relationship analysis
- 📈 “Give me graph statistics and metrics” - Data insights
- 📥 “Import this GraphSON data” - Data loading
- 📤 “Export user data as CSV” - Data extraction
- 🧠 Smart enum discovery - AI learns your data’s valid values automatically
🛠️ Available Tools
Your AI assistant gets access to these powerful tools:
| Tool | Purpose | What It Does |
|---|---|---|
| 🔍 get_graph_status | Health Check | Verify database connectivity and server status |
| 📋 get_graph_schema | Schema Discovery | Get complete graph structure with nodes, edges, and relationships |
| ⚡ run_gremlin_query | Query Execution | Execute any Gremlin traversal query with full syntax support |
| 🔄 refresh_schema_cache | Cache Management | Force immediate refresh of cached schema information |
| 📥 import_graph_data | Data Import | Load data from GraphSON, CSV, or JSON with batch processing |
| 📤 export_subgraph | Data Export | Extract subgraphs to JSON, GraphSON, or CSV formats |
🚀 Quick Setup
Step 1: Install
# The npx command will automatically install the package if needed
# No separate installation step required
Alternative: Build from Source
# Clone and setup
git clone https://github.com/kpritam/gremlin-mcp.git
cd gremlin-mcp
npm install
Установка
npx @kpritam/gremlin-mcpКонфигурация
{
"mcpServers": {
"gremlin": {
"command": "npx",
"args": ["@kpritam/gremlin-mcp"],
"env": {
"GREMLIN_ENDPOINT": "localhost:8182",
"LOG_LEVEL": "info"
}
}
}
}