Registry / aws / awslabs-amazon-neptune-mcp-server

awslabs-amazon-neptune-mcp-server

library1.0.16pypypiunverified

An MCP (Model Context Protocol) server for Amazon Neptune that provides tools to fetch status, schema, and execute queries using openCypher, Gremlin, and SPARQL for Neptune Database, and openCypher for Neptune Analytics. Current version 1.0.16, requires Python >=3.10.

aws

pip install awslabs-amazon-neptune-mcp-server

github ↗package ↗homepage ↗docs ↗changelog ↗

INSTALL

IMPORT

SIG · AWSLABS-AMAZON-NEP

awslabs-amazon-neptune-mcp-server

awspythonv1.0.16

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

NeptuneMCPServer

✓ from awslabs.amazon_neptune_mcp_server import NeptuneMCPServer

✗ from neptune_mcp.server import NeptuneMCPServer

Initialize and run the Neptune MCP server with environment variables for configuration.

from neptune_mcp.server import NeptuneMCPServer # Replace with your Neptune endpoint and port endpoint = os.environ.get('NEPTUNE_ENDPOINT', 'your-neptune-endpoint') port = int(os.environ.get('NEPTUNE_PORT', '8182')) server = NeptuneMCPServer( endpoint=endpoint, port=port, region=os.environ.get('AWS_REGION', 'us-east-1'), # Optional: specify connection type connection_type='database', or 'analytics' ) server.run()

neptune-mcp-server --version

Debug

Known issues

deprecatedThe 'gremlin' extra (gremlinpython) is no longer maintained; consider using openCypher or SPARQL for queries.

fix

Use openCypher by default; set connection_type to 'database' and query language to 'openCypher'.

affects: >=1.0.0

gotchaThe server requires explicit AWS credentials (via environment variables, IAM roles, or ~/.aws/credentials). Missing credentials result in silent failures.

fix

Set AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, and AWS_SESSION_TOKEN (if using temporary credentials) as environment variables.

affects: all

gotchaPort 8182 is hardcoded as default for Neptune Database; Neptune Analytics uses port 8183. Using wrong port leads to connection timeout.

fix

Set NEPTUNE_PORT environment variable or pass port parameter explicitly.

affects: all

Upgrade

Version history

1.0.16latest on PyPI · released Apr 21, 2026

Audit

Dependencies

boto3requiredAWS SDK for Neptune client

gremlinpythonoptionalGremlin query support

sparqlwrapperoptionalSPARQL query support

Agent activity

23 hits · last 30 days

node

Resources

githubhttps://github.com/awslabs/mcp ↗

packagehttps://pypi.org/project/awslabs-amazon-neptune-mcp-server/ ↗

homepagehttps://awslabs.github.io/mcp/ ↗

docshttps://awslabs.github.io/mcp/servers/amazon-neptune-mcp-server/ ↗

changeloghttps://github.com/awslabs/mcp/blob/main/src/amazon-neptune-mcp-server/CHANGELOG.md ↗