← Explore all mcp servers

AWS DATA SERVICES / AWS Labs

AWS Neptune MCP

Inspect graph schema and execute openCypher or Gremlin against a selected Neptune graph.

“Amazon Neptune MCP server for graph status, schema and queries.”

01 / THE REASONING

Why this made the selection.

  • Specialized publisher integration with documented IAM and data access boundaries.
  • Explore graph labels and relationships before writing a bounded openCypher query.
  • The README fetches Neptune status and schema and runs openCypher or Gremlin against a configured endpoint.
  • It does not filter queries to read-only, so the IAM data-plane permissions are the control the file names.

02 / THE REVIEW RECORD

What we actually inspected.

Source review has boundaries.
A clear record is more useful than a “safe” badge.

Material inspected

  • src/amazon-neptune-mcp-server/README.md
  • src/amazon-neptune-mcp-server/pyproject.toml
  • src/amazon-neptune-mcp-server/awslabs/amazon_neptune_mcp_server/server.py
  • Root README.md and LICENSE
  • LICENSE

Our findings

  • The pinned entrypoint forwards query strings to backend query methods without establishing a read-only gate.
  • README and package metadata establish Python >=3.10, VPC requirements and the two endpoint schemes.
  • The server returns graph status and schema and runs openCypher and Gremlin on Neptune Database, and openCypher on Neptune Analytics.
  • It needs an AWS profile that can access Neptune, and the host must reach the endpoint. Neptune Database requires access into its private VPC.
  • The README says the server will run any query, including mutating ones. It does not implement a read-only mode. Data-plane permissions on the role are the control it points to.

Not established by this review

  • Server startup, authentication, live tool execution and security isolation were not tested.
  • Published package/container parity with a source revision and hosted implementation internals were not tested.
  • The server was not started and its tools were not called.
  • A pin does not verify transitive dependencies.
  • No tools/list or tool call was made.

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

Connect a server deliberately.

Upstream setup instructions ↗

DOCUMENTED COMMAND

uvx awslabs.amazon-neptune-mcp-server@latest

Copying does not execute this command. It may retrieve a newer version than the reviewed source.

  1. Configure a dedicated AWS profile and read-only graph data permissions, plus network access to the target.
  2. Set NEPTUNE_ENDPOINT to neptune-db://<cluster endpoint> or neptune-graph://<graph identifier>.
  3. Start the uvx process and inspect status/schema before requesting a bounded query.

Before you start

  • Python 3.10 or newer, uv/uvx and an MCP client that can launch a local stdio process.
  • An AWS account, configured credentials and access to the intended region and service resources.

Documented configuration example

Use the client and authentication context described in the setup guidance. Configuration formats vary between hosts.

{
  "mcpServers": {
    "awslabs-neptune": {
      "command": "uvx",
      "args": [
        "awslabs.amazon-neptune-mcp-server@latest"
      ],
      "env": {
        "AWS_PROFILE": "neptune-reader",
        "AWS_REGION": "us-east-1",
        "NEPTUNE_ENDPOINT": "neptune-db://YOUR_CLUSTER_ENDPOINT",
        "FASTMCP_LOG_LEVEL": "ERROR"
      }
    }
  }
}

04 / FOLLOW THE EVIDENCE

The source trail.

Our notes are separate from the original resource.
Check upstream before adopting a new version.

  1. https://github.com/awslabs/mcp/blob/8840003820a78dd018561d55c7ab12fcdd708464/src/amazon-neptune-mcp-server/README.md

    Supports: summary, install, configExample, access, limitations, bestFor, review, compatibility, transports

  2. https://github.com/awslabs/mcp/blob/8840003820a78dd018561d55c7ab12fcdd708464/src/amazon-neptune-mcp-server/pyproject.toml

    Supports: summary, install, configExample, access, limitations, bestFor, review, compatibility, transports

  3. https://github.com/awslabs/mcp/blob/8840003820a78dd018561d55c7ab12fcdd708464/src/amazon-neptune-mcp-server/awslabs/amazon_neptune_mcp_server/server.py

    Supports: summary, install, configExample, access, limitations, bestFor, review, compatibility, transports

  4. https://github.com/awslabs/mcp/blob/8840003820a78dd018561d55c7ab12fcdd708464/README.md

    Supports: summary, install, configExample, access, limitations, bestFor, review, compatibility, transports

  5. Applicable licence ↗Checked

    https://github.com/awslabs/mcp/blob/8840003820a78dd018561d55c7ab12fcdd708464/LICENSE

    Supports: license

Evidence & Ask