# Amazon Neptune

An MCP server for Amazon Neptune graphs: run openCypher and Gremlin queries, read the graph schema, check whether the graph answers.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 9939 repo stars
- Author: awslabs
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/awslabs/mcp/tree/HEAD/src/amazon-neptune-mcp-server
- Updated: 2026-10-23
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/amazon-neptune

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

## Requirements
- Needs: Docker

## Install

### Claude Code (native platform)

**Install**
- The MCP registry has no launch command for it: see the repository README

## When to use it
- 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
- 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?

## Similar
- [amazon-neptune](https://affpapa.org/en/nevibecode/skills/amazon-neptune.md) — skill · 2200 installs
- [spring-data-neo4j](https://affpapa.org/en/nevibecode/skills/spring-data-neo4j.md) — skill · 4000 installs
- [neo4j-cypher-skill](https://affpapa.org/en/nevibecode/skills/neo4j-cypher-skill.md) — skill · 1600 installs
- [neo4j-modeling-skill](https://affpapa.org/en/nevibecode/skills/neo4j-modeling-skill.md) — skill · 1200 installs
- [graph-database-expert](https://affpapa.org/en/nevibecode/skills/graph-database-expert.md) — skill · 271 installs

From the same set: [awslabs/mcp](https://affpapa.org/en/nevibecode/by/awslabs/mcp.md) — 36 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
