Servidor MCP de Aurora DSQL de Laboratorios de AWS

Un servidor de protocolo de contexto para modelos (MCP) de Laboratorios de AWS para Aurora DSQL

Características

Herramientas disponibles

Operaciones de base de datos

Documentación y recomendaciones

Requisitos previos

Instalación

Uso de uv

Configure el servidor MCP en la configuración del cliente de MCP (por ejemplo, para la CLI de Amazon Q Developer, edite ~/.aws/amazonq/mcp.json):

{
  "mcpServers": {
    "awslabs.aurora-dsql-mcp-server": {
      "command": "uvx",
      "args": [
        "awslabs.aurora-dsql-mcp-server@latest",
        "--cluster_endpoint",
        "[your dsql cluster endpoint, e.g. abcdefghijklmnopqrst234567.dsql.us-east-1.on.aws]",
        "--region",
        "[your dsql cluster region, e.g. us-east-1]",
        "--database_user",
        "[your dsql username, e.g. admin]",
        "--profile",
        "default"
      ],
      "env": {
        "FASTMCP_LOG_LEVEL": "ERROR"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Instalación de Windows

Para los usuarios de Windows, el formato de configuración del servidor MCP es ligeramente diferente:

{
  "mcpServers": {
    "awslabs.aurora-dsql-mcp-server": {
      "disabled": false,
      "timeout": 60,
      "type": "stdio",
      "command": "uv",
      "args": [
        "tool",
        "run",
        "--from",
        "awslabs.aurora-dsql-mcp-server@latest",
        "awslabs.aurora-dsql-mcp-server.exe"
      ],
      "env": {
        "FASTMCP_LOG_LEVEL": "ERROR",
        "AWS_PROFILE": "your-aws-profile",
        "AWS_REGION": "us-east-1"
      }
    }
  }
}

Verificación de la instalación

Para la CLI de Amazon Q Developer, ejecute /mcp para ver el estado del servidor MCP.

Opciones de configuración del servidor

--allow-writes

De forma predeterminada, el servidor mcp de dsql no permite operaciones de escritura (“modo de solo lectura”). Cualquier invocación de la herramienta de transacciones producirá un error en este modo. Para usar la herramienta de transacciones, permita escribir pasando el parámetro --allow-writes.

Recomendamos utilizar el acceso con privilegios mínimos al conectarse a DSQL. Por ejemplo, los usuarios deben usar un rol de solo lectura siempre que sea posible. El modo de solo lectura hace todo lo posible por parte del cliente para rechazar las mutaciones.

--cluster_endpoint

Este parámetro es obligatorio para especificar el clúster al que se va a conectar. Debe ser el punto de conexión completo del clúster, por ejemplo, 01abc2ldefg3hijklmnopqurstu.dsql.us-east-1.on.aws

--database_user

Este parámetro es obligatorio para especificar el usuario como el que se va a conectar. Por ejemplo, admin o my_user. Tenga en cuenta que las credenciales de AWS que utilice deben tener permiso para iniciar sesión como ese usuario. Para obtener más información sobre la configuración y el uso de los roles de base de datos en DSQL, consulte Uso de los roles de base de datos con los roles de IAM.

--profile

Puede especificar el perfil de AWS que va a utilizar para las credenciales. Tenga en cuenta que esto no es compatible con la instalación de docker.

También se admite el uso de la variable de entorno AWS_PROFILE en la configuración de MCP:

"env": {
  "AWS_PROFILE": "your-aws-profile"
}

Si no se proporciona ninguno de los dos, el servidor MCP utilizará de forma predeterminada el perfil “predeterminado” del archivo de configuración de AWS.

--region

Se trata de un parámetro obligatorio para especificar la región de la base de datos de DSQL.

--knowledge-server

Parámetro opcional para especificar el punto de conexión remoto del servidor MCP para las herramientas de conocimiento de DSQL (búsqueda de documentación, lectura y recomendaciones). De forma predeterminada, está preconfigurado.

Ejemplo:

--knowledge-server https://custom-knowledge-server.example.com

Nota: por motivos de seguridad, utilice solo puntos de conexión del servidor de información de confianza. El servidor debe ser un punto de conexión HTTPS.

--knowledge-timeout

Parámetro opcional para especificar el tiempo de espera en segundos para las solicitudes al servidor de información.

Valor predeterminado: 30.0

Ejemplo:

--knowledge-timeout 60.0

Aumente este valor si se agotan los tiempos de espera al acceder a la documentación en redes lentas.