Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

AWS Labs Aurora DSQL MCP Server

Server AWS Labs Model Context Protocol (MCP) untuk Aurora DSQL

Fitur

Alat yang Tersedia

Operasi Database

Dokumentasi dan Rekomendasi

Prasyarat

Penginstalan

Untuk sebagian besar alat, memperbarui konfigurasi dengan mengikuti petunjuk Instalasi Default harus cukup.

Instruksi terpisah diuraikan untuk Claude Code dan Codex.

Instalasi Default: Memperbarui File Konfigurasi MCP yang Relevan

Menggunakan uv

Konfigurasikan server MCP dalam konfigurasi klien MCP Anda (Menemukan File Konfigurasi 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": []
    }
  }
}

Instalasi Windows

Untuk pengguna Windows, format konfigurasi server MCP sedikit berbeda:

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

Menemukan File Konfigurasi Klien MCP

Untuk beberapa alat pengembangan Agentic yang paling umum, Anda dapat menemukan konfigurasi klien MCP Anda di jalur file berikut:

Kode Claude

Prasyarat

Penting: Manajemen server MCP hanya tersedia melalui pengalaman terminal Claude Code CLI, bukan mode panel asli VS Code.

Instal Claude Code CLI terlebih dahulu dengan mengikuti proses yang direkomendasikan instalasi asli Claude.

Memilih Lingkup yang Tepat

Claude Code menawarkan 3 cakupan berbeda: lokal (default), proyek, dan pengguna dan detail ruang lingkup mana yang harus dipilih berdasarkan sensitivitas kredensi dan perlu dibagikan. Lihat dokumentasi Kode Claude di Lingkup Instalasi MCP untuk detail selengkapnya.

Menggunakan Claude CLI (disarankan)

Menggunakan sesi claude CLI interaktif memungkinkan pengalaman pemecahan masalah yang lebih baik, jadi ini adalah jalur yang disarankan.

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

Pemecahan Masalah: Menggunakan Kode Claude dengan Bedrock di Akun AWS yang berbeda

Jika Anda telah mengonfigurasi Claude Code dengan akun atau profil AWS Bedrock yang berbeda dari profil yang diperlukan untuk terhubung ke kluster dsql Anda, Anda harus memberikan argumen lingkungan tambahan:

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

Modifikasi Langsung dalam File Konfigurasi

Kode Claude Memerlukan penamaan alfanumerik, jadi sebaiknya beri nama server Anda:. aurora-dsql-mcp-server

Lingkup Lokal

Perbarui ~/.claude.json dalam bidang khusus proyekmcpServers:

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

Lingkup Proyek

Perbarui /path/to/project/root/.mcp.json di mcpServers bidang:

{
  "mcpServers": {}
}

Lingkup Pengguna

Perbarui ~/.claude.json dalam bidang khusus proyekmcpServers:

{
  "mcpServers": {}
}

kodeks

Opsi 1: Codex CLI

Jika Anda memiliki Codex CLI diinstal, Anda dapat menggunakan perintah codex mcp untuk mengkonfigurasi server MCP Anda.

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

Opsi 2: config.toml

Untuk kontrol lebih halus atas opsi server MCP, Anda dapat mengedit file ~/.codex/config.toml konfigurasi secara manual. Setiap server MCP dikonfigurasi dengan [mcp_servers.<server-name>] tabel di file konfigurasi.

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

Memverifikasi Instalasi

Untuk CLI Pengembang Amazon Q, Kiro CLI, CLI/TUI, or Codex CLI/TUI Claude, /mcp jalankan untuk melihat status server MCP.

Untuk IDE Kiro, Anda juga dapat menavigasi ke MCP SERVERS tab Panel Kiro yang menunjukkan semua server MCP yang dikonfigurasi dan indikator status koneksinya.

Opsi Konfigurasi Server

--allow-writes

Secara default, server mcp dsql tidak mengizinkan operasi tulis (“mode hanya-baca”). Setiap pemanggilan alat transaksi akan gagal dalam mode ini. Untuk menggunakan alat transaksi, izinkan penulisan dengan melewati --allow-writes parameter.

Sebaiknya gunakan akses hak istimewa paling rendah saat menghubungkan ke DSQL. Misalnya, pengguna harus menggunakan peran yang hanya-baca jika memungkinkan. Mode hanya-baca memiliki upaya terbaik penegakan sisi klien untuk menolak mutasi.

--cluster_endpoint

Ini adalah parameter wajib untuk menentukan cluster untuk terhubung ke. Ini harus menjadi titik akhir penuh cluster Anda, misalnya, 01abc2ldefg3hijklmnopqurstu.dsql.us-east-1.on.aws

--database_user

Ini adalah parameter wajib untuk menentukan pengguna untuk terhubung sebagai. Misalnyaadmin, ataumy_user. Perhatikan bahwa kredensil AWS yang Anda gunakan harus memiliki izin untuk masuk sebagai pengguna tersebut. Untuk informasi selengkapnya tentang pengaturan dan penggunaan peran database di DSQL, lihat Menggunakan peran database dengan peran IAM.

--profile

Anda dapat menentukan profil aws yang akan digunakan untuk kredensil Anda. Perhatikan bahwa ini tidak didukung untuk instalasi docker.

Menggunakan variabel AWS_PROFILE lingkungan dalam konfigurasi MCP Anda juga didukung:

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

Jika tidak ada yang disediakan, server MCP default menggunakan profil “default” di file konfigurasi AWS Anda.

--region

Ini adalah parameter wajib untuk menentukan wilayah database DSQL Anda.

--knowledge-server

Parameter opsional untuk menentukan titik akhir server MCP jarak jauh untuk alat pengetahuan DSQL (pencarian dokumentasi, pembacaan, dan rekomendasi). Secara default sudah dikonfigurasi sebelumnya.

Contoh:

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

Catatan: Untuk keamanan, hanya gunakan endpoint server pengetahuan tepercaya. Server harus menjadi titik akhir HTTPS.

--knowledge-timeout

Parameter opsional untuk menentukan batas waktu dalam hitungan detik untuk permintaan ke server pengetahuan.

Default: 30.0

Contoh:

--knowledge-timeout 60.0

Tingkatkan nilai ini jika Anda mengalami batas waktu saat mengakses dokumentasi di jaringan yang lambat.