Configurazione MCP - Amazon Q Developer
Comprendere la configurazione MCP

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à.

Configurazione MCP

La configurazione MCP nell'Amazon Q Developer CLI è gestita tramite file JSON. Questa sezione spiega come configurare i server MCP per estendere le funzionalità di Q.

Comprendere la configurazione MCP

La configurazione del client MCP nell'Amazon Q Developer CLI è archiviata in formato JSON, in un file denominato. mcp.json Questa sezione spiega come funziona la configurazione MCP e come strutturare i file di configurazione.

Posizioni dei file di configurazione

La CLI per sviluppatori di Amazon Q supporta due livelli di configurazione MCP:

  1. Configurazione globale: ~/.aws/amazonq/mcp.json - Si applica a tutte le aree di lavoro

  2. Configurazione dell'area di lavoro: .amazonq/mcp.json - Specifica per l'area di lavoro corrente

Entrambi i file sono opzionali; non possono esistere né uno né entrambi. Se entrambi i file esistono, Amazon Q Developer CLI legge la configurazione MCP da entrambi e li combina, raccogliendo l'unione dei relativi contenuti. In caso di conflitto (ad esempio, un server definito nella configurazione globale è presente anche nella configurazione dell'area di lavoro), viene visualizzato un avviso e viene utilizzata solo la voce del server nella configurazione dell'area di lavoro.

Struttura del file di configurazione

Il file di configurazione MCP utilizza un formato JSON con la seguente struttura:

{
  "mcpServers": {
    "server-name": {
      "command": "command-to-run",
      "args": ["arg1", "arg2"],
      "env": {
        "ENV_VAR1": "value1",
        "ENV_VAR2": "value2"
      },
      "timeout": 60000
    }
  }
}

Ogni voce del server MCP è un oggetto, con il nome del server come chiave. Il nome deve essere univoco all'interno di ogni file di configurazione MCP e tra i file di configurazione globali e di progetto. Il nome del server non deve essere vuoto e non deve superare i 250 caratteri.

Ogni oggetto di immissione del server MCP deve avere la proprietà «command» (per il trasporto stdio) o la proprietà «url» (per il trasporto HTTP, che sarà supportata in una versione futura).

Se nel file JSON sono presenti attributi imprevisti, viene visualizzato un avviso e tali attributi vengono ignorati.

Configurazione del server Stdio

Se la proprietà «command» è presente in una voce, questo server MCP utilizza stdio transport. Sono supportati gli attributi seguenti:

  • command(obbligatorio): Il comando shell da utilizzare per avviare il server MCP. Questa è una stringa che rappresenta un comando shell valido.

  • args(opzionale): Un array di argomenti della riga di comando da passare al server all'avvio. Gli argomenti vengono passati nell'ordine esatto in cui sono definiti nel file di configurazione. Se non è definito, nessun argomento viene passato al server.

  • env(opzionale): Un oggetto contenente variabili di ambiente da impostare all'avvio del server. Ogni valore deve essere una stringa. Se non è definita, non viene impostata alcuna variabile di ambiente.

  • timeout(opzionale): Il tempo massimo, in millisecondi, durante il quale il client attenderà una risposta dal server MCP per una chiamata allo strumento, un prompt o il recupero di una risorsa. Deve essere un valore intero positivo. Se non è definito, viene utilizzato un valore predefinito di 60.000 ms (1 minuto).

Esempio di configurazione di un server stdio:

{
  "mcpServers": {
    "stdio-mcp-server": {
      "command": "mycommand",
      "args": [
        "arg1"
      ],
      "env": {
        "API_KEY": "value1"
      },
      "timeout": 60000
    }
  }
}

Esempi di configurazione

Esempio di base con un singolo server MCP:

{
  "mcpServers": {
    "markdown-tools": {
      "command": "npx",
      "args": [
        "-y",
        "@example/markdown-mcp"
      ]
    }
  }
}

Esempio con più server MCP e variabili di ambiente:

{
  "mcpServers": {
    "git-tools": {
      "command": "npx",
      "args": [
        "-y",
        "@example/git-mcp"
      ],
      "timeout": 30000
    },
    "api-tools": {
      "command": "npx",
      "args": [
        "-y",
        "@example/api-mcp"
      ],
      "env": {
        "API_URL": "https://api.example.com",
        "API_KEY": "your-api-key"
      },
      "timeout": 120000
    }
  }
}

Procedure consigliate di configurazione

  • Utilizzate nomi descrittivi per i server MCP per renderli facilmente identificabili.

  • Utilizzate il file di configurazione globale per i server MCP che desiderate utilizzare in tutti i progetti.

  • Utilizzate file di configurazione specifici dell'area di lavoro per i server MCP che sono rilevanti solo per un particolare progetto.

  • Regola i valori di timeout in base al tempo di risposta previsto per ogni server MCP.

  • Controlla regolarmente gli aggiornamenti dei tuoi server MCP per assicurarti di disporre delle funzionalità e delle correzioni di sicurezza più recenti.

Comandi di configurazione

Utilizzo: Usage: qchat mcp [OPTIONS] COMMAND

Comandi di configurazione MCP
Comando Descrizione
qchat mcp add Aggiungere o sostituire un server configurato
qchat mcp remove Rimuovere un server dalla configurazione MCP
qchat mcp list Elenca i server configurati
qchat mcp import Importa una configurazione del server da un altro file
qchat mcp status Ottieni lo stato di un server configurato
qchat mcp help Stampa questo elenco di comandi o aiuta per i sottocomandi specificati