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
+ Mengubah pertanyaan dan perintah yang dapat dibaca manusia menjadi kueri SQL yang kompatibel dengan Postgres terstruktur dan menjalankannya terhadap database Aurora DSQL yang dikonfigurasi.
+ Hanya baca secara default, transaksi diaktifkan dengan `--allow-writes`
+ Penggunaan kembali koneksi antara permintaan untuk meningkatkan kinerja
+ Akses bawaan ke dokumentasi Aurora DSQL, pencarian, dan rekomendasi praktik terbaik
## Alat yang Tersedia
### Operasi Database
+ **readonly\$1query - Jalankan kueri SQL** read-only terhadap cluster DSQL Anda
+ **transact** - Jalankan operasi tulis dalam transaksi (membutuhkan`--allow-writes`)
+ **get\$1schema - Ambil informasi skema** tabel
### Dokumentasi dan Rekomendasi
+ **dsql\$1search\$1documentation** - Cari dokumentasi Aurora DSQL
+ Parameter: `search_phrase` (wajib), `limit` (opsional)
+ **dsql\$1read\$1documentation - Baca halaman dokumentasi** DSQL tertentu
+ Parameter: `url` (wajib), `start_index` (opsional), `max_length` (opsional)
+ **dsql\$1recommend** - Dapatkan rekomendasi untuk praktik terbaik DSQL
+ Parameter: `url` (diperlukan)
## Prasyarat
1. Akun AWS dengan [Aurora](https://docs.aws.amazon.com/aurora-dsql/latest/userguide/getting-started.html) DSQL Cluster
1. Server MCP ini hanya dapat dijalankan secara lokal pada host yang sama dengan klien LLM Anda.
1. Siapkan kredensil AWS dengan akses ke layanan AWS
+ Anda memerlukan akun AWS dengan peran termasuk izin ini:
+ `dsql:DbConnectAdmin`- Connect ke cluster DSQL sebagai pengguna admin
+ `dsql:DbConnect`- Connect ke cluster DSQL dengan peran database kustom (hanya diperlukan jika menggunakan pengguna non-admin)
+ Konfigurasikan kredensional AWS dengan `aws configure` atau variabel lingkungan
## Penginstalan
Untuk sebagian besar alat, memperbarui konfigurasi dengan mengikuti petunjuk [Instalasi Default](#default-installation) harus cukup.
[Instruksi terpisah diuraikan untuk [Claude Code](#claude-code) dan Codex.](#codex)
### Instalasi Default: Memperbarui File Konfigurasi MCP yang Relevan
#### Menggunakan `uv`
1. [Instal `uv` dari [Astral](https://docs.astral.sh/uv/getting-started/installation/) atau README GitHub](https://github.com/astral-sh/uv#installation)
1. Instal Python menggunakan `uv python install 3.10`
Konfigurasikan server MCP dalam konfigurasi klien MCP Anda ([Menemukan File Konfigurasi MCP](#finding-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",
"[your aws profile, e.g. 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:
+ Kiro:
+ Konfigurasi Pengguna: `~/.kiro/settings/mcp.json`
+ Config Ruang Kerja: `/path/to/workspace/.kiro/settings/mcp.json`
+ Kode Claude: Lihat [Instalasi Kode Claude untuk bantuan](#claude-code) pengaturan terperinci
+ Konfigurasi Pengguna: di `~/.claude.json` `"mcpServers"`
+ Konfigurasi Proyek: `/path/to/project/.mcp.json`
+ Config Lokal: di `~/.claude.json` `"projects" -> "path/to/project" -> "mcpServers"`
+ Kursor:
+ Global: `~/.cursor/mcp.json`
+ Proyek: `/path/to/project/.cursor/mcp.json`
+ Kodeks: `~/.codex/config.toml`
+ Setiap server MCP dikonfigurasi dengan `[mcp_servers.]` tabel di file konfigurasi. Lihat Petunjuk [Instalasi Codex Kustom](#codex)
+ Lengkung:
+ Pengeditan File: `~/.warp/mcp_settings.json`
+ Editor Aplikasi: `Settings > AI > Manage MCP Servers` dan tempel json
+ CLI Pengembang Amazon Q: `~/.aws/amazonq/mcp.json`
+ Cline: Biasanya jalur VS Code bersarang - `~/.vscode-server/path/to/cline_mcp_settings.json`
### 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.](https://code.claude.com/docs/en/setup#native-install-recommended)
#### 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](https://code.claude.com/docs/en/mcp#mcp-installation-scopes) untuk detail selengkapnya.
1. Server dengan **cakupan lokal** mewakili tingkat konfigurasi default dan disimpan di `~/.claude.json` bawah jalur proyek Anda. **Keduanya** bersifat pribadi untuk Anda dan hanya dapat diakses dalam direktori proyek saat ini. Ini adalah default `scope` saat membuat server MCP.
1. Server dengan **cakupan proyek** **memungkinkan kolaborasi tim** sementara masih hanya dapat diakses di direktori proyek. Server dengan cakupan proyek menambahkan `.mcp.json` file di direktori root proyek Anda. File ini dirancang untuk diperiksa ke kontrol versi, memastikan semua anggota tim memiliki akses ke alat dan layanan MCP yang sama. Saat Anda menambahkan server cakupan proyek, Claude Code secara otomatis membuat atau memperbarui file ini dengan struktur konfigurasi yang sesuai.
1. **Server **dengan cakupan pengguna** disimpan `~/.claude.json` dan **menyediakan aksesibilitas lintas proyek**, membuatnya tersedia di semua proyek di komputer Anda sambil tetap pribadi ke akun pengguna Anda.**
#### 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 proyek`mcpServers`:
```
{
"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 proyek`mcpServers`:
```
{
"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.]` tabel di file konfigurasi.
```
[mcp_servers.amazon-aurora-dsql]
command = "uvx"
args = [
"awslabs.aurora-dsql-mcp-server@latest",
"--cluster_endpoint", ".dsql..on.aws",
"--region", "",
"--database_user", ""
]
[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. Misalnya`admin`, atau`my_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](https://docs.aws.amazon.com/aurora-dsql/latest/userguide/using-database-and-iam-roles.html).
### `--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.