{"id":23314,"library":"awslabs-aurora-dsql-mcp-server","title":"Aurora DSQL MCP Server","description":"An AWS Labs Model Context Protocol (MCP) server for Amazon Aurora DSQL. Provides a Python server that exposes DSQL operations via the MCP interface. Version 1.0.27, actively developed with weekly releases.","status":"active","version":"1.0.27","language":"python","source_language":"en","source_url":"https://github.com/awslabs/aurora-dsql-mcp-server","tags":["aws","aurora","dsql","mcp","server","database"],"install":[{"cmd":"pip install awslabs-aurora-dsql-mcp-server","lang":"bash","label":"PyPI"}],"dependencies":[],"imports":[{"note":"PyPI name has hyphens, import uses underscores but the package name on PyPI is 'awslabs-aurora-dsql-mcp-server'. The correct import module is 'aurora_dsql_mcp_server' (without 'awslabs' prefix).","wrong":"from awslabs_aurora_dsql_mcp_server import AuroraDsqlMcpServer","symbol":"AuroraDsqlMcpServer","correct":"from aurora_dsql_mcp_server import AuroraDsqlMcpServer"},{"note":"","wrong":"","symbol":"create_app","correct":"from aurora_dsql_mcp_server import create_app"}],"quickstart":{"code":"from aurora_dsql_mcp_server import AuroraDsqlMcpServer\nimport os\n\n# Configure AWS credentials via environment variables\nserver = AuroraDsqlMcpServer(\n    region=os.environ.get('AWS_REGION', 'us-east-1'),\n    cluster_arn=os.environ.get('DSQL_CLUSTER_ARN', ''),\n    secret_arn=os.environ.get('DSQL_SECRET_ARN', '')\n)\n\n# Run the MCP server\nserver.run()","lang":"python","description":"Initialize and run the Aurora DSQL MCP server. Requires AWS credentials (via env variables or IAM role) and DSQL cluster/secret ARNs."},"warnings":[{"fix":"Upgrade Python to 3.10+","message":"Python >=3.10 required. Installation on Python 3.9 or earlier will fail.","severity":"breaking","affected_versions":"all"},{"fix":"Use `from aurora_dsql_mcp_server import AuroraDsqlMcpServer`","message":"The correct import module is 'aurora_dsql_mcp_server', not 'awslabs_aurora_dsql_mcp_server' — many users mistakenly use the PyPI name with hyphens replaced by underscores.","severity":"gotcha","affected_versions":"all"},{"fix":"Replace `endpoint=...` with `cluster_arn=...`","message":"In v1.0.20+, the constructor argument 'endpoint' was renamed to 'cluster_arn'. Old code using 'endpoint' will raise TypeError.","severity":"deprecated","affected_versions":">=1.0.20"}],"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-aurora-dsql-mcp-server` then import with `from aurora_dsql_mcp_server import AuroraDsqlMcpServer`","cause":"Wrong import path: using PyPI name with underscores instead of the actual module name.","error":"ModuleNotFoundError: No module named 'awslabs_aurora_dsql_mcp_server'"},{"fix":"Use `cluster_arn` instead of `endpoint` when creating AuroraDsqlMcpServer.","cause":"The parameter was renamed from 'endpoint' to 'cluster_arn' in v1.0.20.","error":"TypeError: __init__() got an unexpected keyword argument 'endpoint'"},{"fix":"Set environment variables AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, and optionally AWS_SESSION_TOKEN, or use an IAM role.","cause":"AWS credentials not configured. The server needs valid AWS credentials to access DSQL.","error":"botocore.exceptions.NoCredentialsError: Unable to locate credentials"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}