Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Server MCP DSQL Aurora di AWS Labs

Un server MCP (Model Context Protocol) di AWS Labs per Aurora DSQL

Funzionalità

Strumenti disponibili

Operazioni del database

Documentazione e raccomandazioni

Prerequisiti

Installazione

Per la maggior parte degli strumenti, dovrebbe essere sufficiente aggiornare la configurazione seguendo le istruzioni di installazione predefinite.

Sono riportate istruzioni separate per Claude Code e Codex.

Installazione predefinita: aggiornamento del file di configurazione MCP pertinente

Uso di uv

Configurare il server MCP nella configurazione del client MCP (Finding the MCP Config File)

{
  "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": []
    }
  }
}

Installazione di Windows

Per gli utenti Windows, il formato di configurazione del server MCP è leggermente diverso:

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

Individuazione del file di configurazione del client MCP

Per alcuni degli strumenti di sviluppo Agentic più comuni, è possibile trovare le configurazioni dei client MCP nei seguenti percorsi di file:

Codice Claude

Prerequisiti

Importante: la gestione del server MCP è disponibile solo tramite l'esperienza del terminale CLI di Claude Code, non la modalità pannello nativa di VS Code.

Installa prima la CLI di Claude Code seguendo la procedura di installazione nativa consigliata da Claude.

Scelta dell'ambito giusto

Claude Code offre 3 diversi ambiti: locale (predefinito), di progetto e utente e specifica quale ambito scegliere in base alla sensibilità delle credenziali e alla necessità di condividere. Per maggiori dettagli, consulta la documentazione di Claude Code sugli ambiti di installazione MCP.

Utilizzo della CLI di Claude (consigliato)

L'utilizzo di una sessione claude CLI interattiva consente una migliore esperienza di risoluzione dei problemi, quindi questo è il percorso consigliato.

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

Risoluzione dei problemi: utilizzo di Claude Code con Bedrock su un altro account AWS

Se hai configurato Claude Code con un account o un profilo Bedrock AWS diverso dal profilo necessario per connetterti al tuo cluster dsql, dovrai fornire argomenti di ambiente aggiuntivi:

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

Modifica diretta nel file di configurazione

Claude Code Richiede una denominazione alfanumerica, quindi ti consigliamo di assegnare un nome al tuo server:. aurora-dsql-mcp-server

Ambito locale

Aggiornamento ~/.claude.json all'interno del campo specifico del progettomcpServers:

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

Ambito del progetto

Aggiornamento sul /path/to/project/root/.mcp.json campo: mcpServers

{
  "mcpServers": {}
}

Ambito dell'utente

Aggiornamento ~/.claude.json all'interno del campo specifico del progetto: mcpServers

{
  "mcpServers": {}
}

Codex

Opzione 1: Codex CLI

Se hai installato la CLI Codex, puoi usare il comando codex mcp per configurare i tuoi server 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]"

Opzione 2: config.toml

Per un controllo più preciso sulle opzioni del server MCP, puoi modificare manualmente il file di configurazione. ~/.codex/config.toml Ogni server MCP è configurato con una [mcp_servers.<server-name>] tabella nel file di configurazione.

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

Verifica dell'installazione

Per Amazon Q Developer CLI, Kiro CLI, CLI/TUI, or Codex CLI/TUI Claude, /mcp esegui per vedere lo stato del server MCP.

Per l'IDE Kiro, puoi anche accedere alla MCP SERVERS scheda del pannello Kiro che mostra tutti i server MCP configurati e i relativi indicatori di stato della connessione.

Opzioni di configurazione del server

--allow-writes

Per impostazione predefinita, il server dsql mcp non consente operazioni di scrittura («modalità di sola lettura»). Qualsiasi richiamo dello strumento transact avrà esito negativo in questa modalità. Per utilizzare lo strumento di transazione, consenti le scritture passando il parametro. --allow-writes

Si consiglia di utilizzare l'accesso con privilegi minimi per la connessione a DSQL. Ad esempio, gli utenti devono utilizzare un ruolo di sola lettura quando possibile. La modalità di sola lettura prevede l'applicazione sul lato client del massimo impegno per rifiutare le mutazioni.

--cluster_endpoint

Questo è un parametro obbligatorio per specificare il cluster a cui connettersi. Questo dovrebbe essere l'endpoint completo del cluster, ad esempio 01abc2ldefg3hijklmnopqurstu.dsql.us-east-1.on.aws

--database_user

Questo è un parametro obbligatorio per specificare l'utente con cui connettersi. Ad esempio admin o my_user. Tieni presente che le credenziali AWS che stai utilizzando devono avere l'autorizzazione per accedere come tale utente. Per ulteriori informazioni sulla configurazione e l'utilizzo dei ruoli del database in DSQL, consulta Using database roles with IAM roles.

--profile

Puoi specificare il profilo aws da utilizzare per le tue credenziali. Nota che questo non è supportato per l'installazione dei docker.

È supportato anche l'utilizzo della variabile di AWS_PROFILE ambiente nella configurazione MCP:

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

Se non viene fornito nessuno dei due, il server MCP utilizza per impostazione predefinita il profilo «predefinito» nel file di configurazione AWS.

--region

Questo è un parametro obbligatorio per specificare la regione del database DSQL.

--knowledge-server

Parametro opzionale per specificare l'endpoint del server MCP remoto per gli strumenti di conoscenza DSQL (ricerca della documentazione, lettura e consigli). Per impostazione predefinita, è preconfigurato.

Esempio:

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

Nota: per motivi di sicurezza, utilizza solo endpoint Knowledge Server affidabili. Il server deve essere un endpoint HTTPS.

--knowledge-timeout

Parametro opzionale per specificare il timeout in secondi per le richieste al knowledge server.

Impostazione predefinita: 30.0

Esempio:

--knowledge-timeout 60.0

Aumentate questo valore se si verificano dei timeout durante l'accesso alla documentazione su reti lente.