get_graph_statusLABSCO SUMMARY
Enum discovery is the feature that stops the wrong-value loop.
A model that knows a property is a string will guess a value, and a guess that misses returns nothing — which reads like an empty result rather than a mistake. Sampling the actual distinct values and shipping them in the schema removes that whole failure mode. High-cardinality fields, IDs, UUIDs, timestamps and long text are excluded automatically, and GREMLIN_SCHEMA_INCLUDE_SAMPLE_VALUES stays off by default to keep the schema small.
What it is
A graph database server for Apache TinkerPop and anything else that speaks Gremlin. It discovers the schema, executes traversals, and imports and exports data.
What you get
get_graph_schemareturns the full structure — node types, edge types and how they connectrun_gremlin_queryexecutes any Gremlin traversal with full syntax supportget_graph_statusverifies connectivity and server status;refresh_schema_cacheforces the cached schema to reloadimport_graph_dataloads GraphSON, CSV or JSON with batch processing;export_subgraphextracts to JSON, GraphSON or CSV- Automatic enum discovery scans low-cardinality properties and puts their real values in the schema, so a status filter uses CONFIRMED rather than a guessed 'active'
Requirements
The npm package @kpritam/gremlin-mcp, run with npx, on Node.js 18.0.0 or newer. GREMLIN_ENDPOINT points at your server, for example localhost:8182; GREMLIN_USERNAME, GREMLIN_PASSWORD and GREMLIN_USE_SSL cover authenticated deployments. Enum discovery is tunable: GREMLIN_ENUM_CARDINALITY_THRESHOLD defaults to 10, GREMLIN_ENUM_PROPERTY_BLACKLIST excludes properties, and GREMLIN_ENUM_DISCOVERY_ENABLED turns it off.
Setup effort
One command — npx @kpritam/gremlin-mcp
USE CASES
01
Understanding a graph you have not seen
Read the schema, including the real values each low-cardinality property takes.
02
Asking a relationship question
Turn "find the shortest path between these two" into a traversal and read back the result.
03
Loading data you were given
Import GraphSON, CSV or JSON in batches and get the status reported back.
04
Taking a slice of the graph elsewhere
Export a subgraph as JSON, GraphSON or CSV for another tool.
6 tools
Listed in project docs. Your client may show a different list.
get_graph_schemarun_gremlin_queryrefresh_schema_cacheimport_graph_dataexport_subgraphBEFORE YOU INSTALL
What to know first
Tools you get
6 tools named in the project's documentation.
Requires
npx on PATH
Where it runs
All 5 documented setups run the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
npx @kpritam/gremlin-mcpMCP Clients
Claude Desktop, Cursor, Windsurf
JSON
{
"mcpServers": {
"gremlin": {
"command": "npx",
"args": [
"@kpritam/gremlin-mcp"
],
"env": {
"GREMLIN_ENDPOINT": "localhost:8182",
"LOG_LEVEL": "info"
}
}
}
}Claude Desktop — from source, Cursor — from source
JSON
{
"mcpServers": {
"gremlin": {
"command": "node",
"args": [
"<YOUR_PATH_TO_GREMLIN_MCP>/dist/server.js"
],
"env": {
"GREMLIN_ENDPOINT": "localhost:8182",
"LOG_LEVEL": "info"
}
}
}
}
