Amazon Neptune — Claude Code MCP server: Cypher and Gremlin queries
An MCP server for Amazon Neptune graphs: run openCypher and Gremlin queries, read the graph schema, check whether the graph answers.
Apache-2.0 ★ 9,939 updated 2026-10-23
Open on GitHubWhat Amazon Neptune does
Three tools come with the server: run openCypher or Gremlin against the configured graph, return its schema as text, and report the graph as available or unavailable. That status check is the quick way to confirm a connection before the agent starts writing queries.
Start it with uvx awslabs.amazon-neptune-mcp-server@latest. The client config carries NEPTUNE_ENDPOINT plus AWS_PROFILE, AWS_REGION and FASTMCP_LOG_LEVEL. Endpoints take one of two forms: neptune-db://<Cluster Endpoint> for a database, neptune-graph://<graph identifier> for Analytics. Windows wants its own block with uv tool run --from.
You need AWS CLI credentials for a profile that can reach Neptune, and at least one graph to point at. A Neptune Database sits inside a private VPC, so whatever host runs the server has to get into that VPC. Keep the IAM role tight: the server passes along every query it receives, mutations included.
What it helps with
- read a graph schema without opening the AWS console
- run a Gremlin query against Neptune Database from the chat
- confirm the graph is reachable before a batch of queries
- draft openCypher for Neptune Analytics from a plain description
- let the agent trace edges without copying results by hand
Example prompts for the agent
- Show me the schema of the Neptune graph and list its vertex and edge labels
- Run this openCypher on Neptune Analytics: match every Person vertex
- Is the graph available right now?
How to install Amazon Neptune
Install
The MCP registry has no launch command for it: see the repository README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Amazon Neptune
How do I connect Amazon Neptune MCP Server to Claude Code?
Add it to your MCP client config. Install uv, run uv python install 3.10, then set command to uvx, args to awslabs.amazon-neptune-mcp-server@latest, and put NEPTUNE_ENDPOINT with your graph endpoint in env, together with AWS_PROFILE and AWS_REGION.
What does Amazon Neptune MCP Server do?
It lets the agent query a configured graph with openCypher or Gremlin, returns the graph schema as text, and tells you whether the graph is available.
Which IAM permissions does the server need?
Access to Neptune and permission to query it. Every query the server receives goes to the graph, writes included, so spell out the allowed data plane actions. Neptune Database also requires network access into its private VPC.