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

Para la mayoría de las herramientas, basta con actualizar la configuración siguiendo las instrucciones de Instalación predeterminada.

Se detallan instrucciones aparte para Claude Code y Codex.

Instalación predeterminada: actualización del archivo de configuración MCP pertinente

Uso de uv

Configure el servidor MCP en la configuración del cliente de MCP (Búsqueda del archivo de configuración MCP)

{
  "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",
        "[your aws profile, e.g. 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"
      }
    }
  }
}

Búsqueda del archivo de configuración del cliente de MCP

Para ver algunas de las herramientas de desarrollo de Agentic más comunes, puede encontrar las configuraciones del cliente de MCP en las siguientes rutas de archivo:

Claude Code

Requisitos previos

Importante: La administración de servidores MCP solo está disponible a través de la experiencia de terminal de la CLI de Claude Code, no del modo de panel nativo de VS Code.

Instale primero la CLI de Claude Code. Para ello, siga el proceso recomendado de instalación nativa de Claude.

Elección del ámbito adecuado

Claude Code ofrece tres ámbitos diferentes: local (predeterminado), proyecto y usuario, y detalla qué ámbito elegir en función de la confidencialidad de las credenciales y de la necesidad de compartirlas. Consulte la documentación de Claude Code sobre los ámbitos de instalación de MCP para obtener más detalles.

Uso de la CLI de Claude (recomendado)

El uso de una sesión de la CLI de claude interactiva permite mejorar la experiencia de solución de problemas, por lo que esta es la ruta recomendada.

claude mcp add amazon-aurora-dsql \
  --scope [one of local, project, or user] \
  --env FASTMCP_LOG_LEVEL="ERROR" \
  -- uvx "awslabs.aurora-dsql-mcp-server@latest" \
  --cluster_endpoint "[dsql-cluster-id].dsql.[region].on.aws" \
  --region "[dsql cluster region, eg. us-east-1]" \
  --database_user "[your-username]"

Solución de problemas: uso de Claude Code con Bedrock en otra cuenta de AWS

Si ha configurado Claude Code con una cuenta o un perfil de AWS de Bedrock que sea distinto del perfil necesario para conectarse a su clúster de DSQL, tendrá que proporcionar argumentos de entorno adicionales:

  --env AWS_PROFILE="[dsql profile, eg. default]" \
  --env AWS_REGION="[dsql cluster region, eg. us-east-1]" \

Modificación directa en el archivo de configuración

Claude Code requiere una nomenclatura alfanumérica, por lo que recomendamos nombrar su servidor: aurora-dsql-mcp-server.

Ámbito local

Actualice ~/.claude.json dentro del campo mcpServers específico del proyecto:

{
  "projects": {
    "/path/to/project": {
      "mcpServers": {}
    }
  }
}

Ámbito de proyecto

Actualice /path/to/project/root/.mcp.json en el campo mcpServers:

{
  "mcpServers": {}
}

Ámbito de usuario

Actualice ~/.claude.json dentro del campo mcpServers específico del proyecto:

{
  "mcpServers": {}
}

Codex

Opción 1: CLI de Codex

Si tiene instalada la CLI de Codex, puede utilizar el comando codex mcp para configurar los servidores MCP.

codex mcp add amazon-aurora-dsql \
  --env FASTMCP_LOG_LEVEL="ERROR" \
  -- uvx "awslabs.aurora-dsql-mcp-server@latest" \
  --cluster_endpoint "[dsql-cluster-id].dsql.[region].on.aws" \
  --region "[dsql cluster region, eg. us-east-1]" \
  --database_user "[your-username]"

Opción 2: config.toml

Para controlar con mayor precisión las opciones del servidor MCP, puede editar manualmente el archivo de configuración ~/.codex/config.toml. Cada servidor MCP se configura con una tabla [mcp_servers.<server-name>] en el archivo de configuración.

[mcp_servers.amazon-aurora-dsql]
command = "uvx"
args = [
  "awslabs.aurora-dsql-mcp-server@latest",
  "--cluster_endpoint", "<DSQL_CLUSTER_ID>.dsql.<AWS_REGION>.on.aws",
  "--region", "<AWS_REGION>",
  "--database_user", "<DATABASE_USERNAME>"
]

[mcp_servers.amazon-aurora-dsql.env]
FASTMCP_LOG_LEVEL = "ERROR"

Verificación de la instalación

Para la CLI de Amazon Q Developer, la CLI de Kiro, la CLI/TUI de Claude o la CLI/TUI de Codex, ejecute /mcp para ver el estado del servidor MCP.

En el caso del IDE de Kiro, también puede ir a la pestaña MCP SERVERS del panel de Kiro, donde se muestran todos los servidores MCP configurados y sus indicadores de estado de conexión.

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.