Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Serveur MCP SQL Aurora d'AWS Labs

Un serveur AWS Labs Model Context Protocol (MCP) pour Aurora DSQL

Caractéristiques

Outils disponibles

Opérations sur les bases

Documentation et recommandations

Conditions préalables

Installation

Pour la plupart des outils, la mise à jour de la configuration en suivant les instructions d'installation par défaut devrait être suffisante.

Des instructions distinctes sont décrites pour Claude Code et Codex.

Installation par défaut : mise à jour du fichier de configuration MCP approprié

Utilisation de uv

Configurez le serveur MCP dans la configuration de votre client MCP (Trouver le fichier de configuration 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",
        "default"
      ],
      "env": {
        "FASTMCP_LOG_LEVEL": "ERROR"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Installation de Windows

Pour les utilisateurs de Windows, le format de configuration du serveur MCP est légèrement différent :

{
  "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"
      }
    }
  }
}

Trouver le fichier de configuration du client MCP

Pour certains des outils de développement Agentic les plus courants, vous pouvez trouver les configurations de vos clients MCP dans les chemins de fichier suivants :

Claude Code

Conditions préalables

Important : la gestion du serveur MCP n'est disponible que via l'expérience du terminal Claude Code CLI, et non via le mode de panneau natif de VS Code.

Installez d'abord la CLI Claude Code en suivant le processus d'installation natif recommandé par Claude.

Choisir le bon oscilloscope

Claude Code propose 3 champs d'application différents : local (par défaut), projet et utilisateur, et indique le champ d'application à choisir en fonction de la sensibilité des informations d'identification et du besoin de partage. Reportez-vous à la documentation Claude Code sur les étendues d'installation MCP pour plus de détails.

Utilisation de la CLI Claude (recommandé)

L'utilisation d'une session claude CLI interactive permet d'améliorer l'expérience de dépannage. C'est donc la voie recommandée.

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]"

Résolution des problèmes : utilisation de Claude Code avec Bedrock sur un autre compte AWS

Si vous avez configuré Claude Code avec un compte ou un profil Bedrock AWS distinct du profil requis pour vous connecter à votre cluster dsql, vous devrez fournir des arguments d'environnement supplémentaires :

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

Modification directe dans le fichier de configuration

Claude Code nécessite une dénomination alphanumérique, nous vous recommandons donc de nommer votre serveur :aurora-dsql-mcp-server.

Portée locale

Mettre à jour ~/.claude.json dans le champ spécifique au projet mcpServers :

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

Portée du projet

Mise /path/to/project/root/.mcp.json à jour sur le mcpServers terrain :

{
  "mcpServers": {}
}

Champ d'application utilisateur

Mettre à jour ~/.claude.json dans le champ spécifique au projet mcpServers :

{
  "mcpServers": {}
}

Codex

Option 1 : CLI du Codex

Si la CLI Codex est installée, vous pouvez utiliser la commande codex mcp pour configurer vos serveurs 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]"

Option 2 : config.toml

Pour un contrôle plus précis des options du serveur MCP, vous pouvez modifier manuellement le fichier de ~/.codex/config.toml configuration. Chaque serveur MCP est configuré avec une [mcp_servers.<server-name>] table dans le fichier de configuration.

[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"

Vérification de l'installation

Pour Amazon Q Developer CLI, Kiro CLICLI/TUI, or Codex CLI/TUI, Claude, exécutez /mcp pour voir l'état du serveur MCP.

Pour l'IDE Kiro, vous pouvez également accéder à l'MCP SERVERSonglet du panneau Kiro qui affiche tous les serveurs MCP configurés et leurs indicateurs d'état de connexion.

Options de configuration du serveur

--allow-writes

Par défaut, le serveur dsql mcp n'autorise pas les opérations d'écriture (« mode lecture seule »). Toute invocation de l'outil de transaction échouera dans ce mode. Pour utiliser l'outil de transaction, autorisez les écritures en passant un --allow-writes paramètre.

Nous recommandons d'utiliser l'accès avec le moindre privilège lors de la connexion à DSQL. Par exemple, les utilisateurs doivent utiliser un rôle en lecture seule lorsque cela est possible. Le mode lecture seule permet de faire de son mieux côté client pour rejeter les mutations.

--cluster_endpoint

Il s'agit d'un paramètre obligatoire pour spécifier le cluster auquel se connecter. Il doit s'agir du point de terminaison complet de votre cluster, par exemple 01abc2ldefg3hijklmnopqurstu.dsql.us-east-1.on.aws

--database_user

Il s'agit d'un paramètre obligatoire pour spécifier l'utilisateur sous lequel se connecter. Par exemple : admin ou my_user. Notez que les informations d'identification AWS que vous utilisez doivent être autorisées à vous connecter en tant qu'utilisateur. Pour plus d'informations sur la configuration et l'utilisation des rôles de base de données dans DSQL, consultez la section Utilisation de rôles de base de données avec des rôles IAM.

--profile

Vous pouvez spécifier le profil AWS à utiliser pour vos informations d'identification. Notez que cela n'est pas pris en charge pour l'installation de docker.

L'utilisation de la variable d'AWS_PROFILEenvironnement dans votre configuration MCP est également prise en charge :

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

Si aucun des deux n'est fourni, le serveur MCP utilise par défaut le profil « par défaut » dans votre fichier de configuration AWS.

--region

Il s'agit d'un paramètre obligatoire pour spécifier la région de votre base de données DSQL.

--knowledge-server

Paramètre facultatif permettant de spécifier le point de terminaison du serveur MCP distant pour les outils de connaissances DSQL (recherche de documentation, lecture et recommandations). Par défaut, il est préconfiguré.

Exemple :

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

Remarque : Pour des raisons de sécurité, utilisez uniquement des points de terminaison de serveur de connaissances fiables. Le serveur doit être un point de terminaison HTTPS.

--knowledge-timeout

Paramètre facultatif pour spécifier le délai d'expiration en secondes pour les demandes adressées au serveur de connaissances.

Valeur par défaut : 30.0

Exemple :

--knowledge-timeout 60.0

Augmentez cette valeur si vous rencontrez des délais d'attente lors de l'accès à la documentation sur des réseaux lents.