{"id":26759,"library":"awslabs-amazon-neptune-mcp-server","title":"Amazon Neptune MCP Server","description":"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.","status":"active","version":"1.0.16","language":"python","source_language":"en","source_url":"https://github.com/awslabs/amazon-neptune-mcp-server","tags":["mcp","neptune","amazon","graph-database","aws","gremlin","openCypher","sparql"],"install":[{"cmd":"pip install awslabs-amazon-neptune-mcp-server","lang":"bash","label":"Install from PyPI"},{"cmd":"pip install awslabs-amazon-neptune-mcp-server[gremlin]","lang":"bash","label":"Install with Gremlin support"},{"cmd":"pip install awslabs-amazon-neptune-mcp-server[all]","lang":"bash","label":"Install with all extras"}],"dependencies":[{"reason":"AWS SDK for Neptune client","package":"boto3","optional":false},{"reason":"Gremlin query support","package":"gremlinpython","optional":true},{"reason":"SPARQL query support","package":"sparqlwrapper","optional":true}],"imports":[{"note":"Main server class","symbol":"NeptuneMCPServer","correct":"from neptune_mcp.server import NeptuneMCPServer"}],"quickstart":{"code":"from neptune_mcp.server import NeptuneMCPServer\n\n# Replace with your Neptune endpoint and port\nendpoint = os.environ.get('NEPTUNE_ENDPOINT', 'your-neptune-endpoint')\nport = int(os.environ.get('NEPTUNE_PORT', '8182'))\n\nserver = NeptuneMCPServer(\n    endpoint=endpoint,\n    port=port,\n    region=os.environ.get('AWS_REGION', 'us-east-1'),\n    # Optional: specify connection type\n    connection_type='database',  or 'analytics'\n)\nserver.run()","lang":"python","description":"Initialize and run the Neptune MCP server with environment variables for configuration."},"warnings":[{"fix":"Use openCypher by default; set connection_type to 'database' and query language to 'openCypher'.","message":"The 'gremlin' extra (gremlinpython) is no longer maintained; consider using openCypher or SPARQL for queries.","severity":"deprecated","affected_versions":">=1.0.0"},{"fix":"Set AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, and AWS_SESSION_TOKEN (if using temporary credentials) as environment variables.","message":"The server requires explicit AWS credentials (via environment variables, IAM roles, or ~/.aws/credentials). Missing credentials result in silent failures.","severity":"gotcha","affected_versions":"all"},{"fix":"Set NEPTUNE_PORT environment variable or pass port parameter explicitly.","message":"Port 8182 is hardcoded as default for Neptune Database; Neptune Analytics uses port 8183. Using wrong port leads to connection timeout.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Run 'pip install awslabs-amazon-neptune-mcp-server' and import 'neptune_mcp'.","cause":"Package not installed or wrong import path.","error":"ModuleNotFoundError: No module named 'neptune_mcp'"},{"fix":"Configure AWS credentials via environment variables (AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY) or IAM role.","cause":"AWS credentials not configured.","error":"botocore.exceptions.NoCredentialsError: Unable to locate credentials"},{"fix":"Verify the Neptune endpoint and port (8182 for Database, 8183 for Analytics). Ensure security groups allow inbound traffic on the port.","cause":"Endpoint or port is incorrect, or network not accessible.","error":"ConnectionError: Could not connect to Neptune endpoint: ..."}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}