Skip to main content
MCP server CX Codex

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 GitHub

What 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.

Similar MCP servers

All MCP servers for Data and databases →

From the same set36

The whole set →
AWS CDK Puts AWS CDK knowledge in front of your coding agent: infrastructure-as-code patterns and CDK Nag security checks. CX Codex +1 ★ 9,939repo stars AWS Bedrock Data Automation AWS Bedrock Data Automation — an MCP server to inspect documents, images, video recordings, and audio files via Amazon Bedrock. CX Codex +1 ★ 9,939repo stars AWS Bedrock Custom Model Import The AWS Bedrock Custom Model Import MCP server lets an agent create and track Amazon Bedrock model import jobs, inspect imported models, and remove them when needed. CX Codex +1 ★ 9,939repo stars AWS AppSync Lets an AI assistant build AWS AppSync GraphQL APIs: schemas, resolvers, data sources, API keys. CX Codex +1 ★ 9,939repo stars AWS API AWS API connects your assistant to AWS resources via AWS CLI commands. Useful when you need to manage cloud infrastructure from the chat. CX Codex +1 ★ 9,939repo stars Amazon Q Business This MCP server sends queries to an Amazon Q Business application and returns answers based on its ingested content. It requires an anonymous-mode application and configured AWS access. CX Codex +1 ★ 9,939repo stars Amazon Kendra Index Amazon Kendra Index connects Amazon Kendra indices to AI coding assistants for RAG context. Useful when you need answers sourced directly from enterprise documentation stored in AWS. CX Codex +1 ★ 9,939repo stars AWS Bedrock AgentCore AWS Bedrock AgentCore is an MCP server that connects AI agents to Amazon Bedrock AgentCore APIs for runtime, memory, identity, gateway, and policy operations through 122 tools. CX Codex +1 ★ 9,939repo stars

Project sponsors

Companies that keep this analytics open