Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Konfigurasi Alat Server Amazon ECS MCP
Panduan ini menunjukkan semua konfigurasi yang tersedia untuk Amazon ECS MCP Server yang dikelola sepenuhnya.
**catatan**
Server Amazon ECS MCP sedang dalam rilis pratinjau dan dapat berubah sewaktu-waktu.
## Variabel-variabel lingkungan
**AWS\_PROFILE** (opsional)
AWS kredensi nama profil untuk digunakan; dapat diganti dengan argumen baris perintah. `--profile`
Contoh: `export AWS_PROFILE=dev`
**AWS\_REGION** (opsional)
AWS wilayah untuk penandatanganan SigV4; default jika tidak disetel. `us-west-2`
Contoh: `export AWS_REGION=us-west-2`
## Argumen
URL **titik akhir SIgV4 MCP (wajib**)
URL endpoint MCP untuk terhubung ke.
Contoh: `https://ecs-mcp.us-west-2.api.aws/mcp`
**--service** (opsional)
AWS nama layanan untuk penandatanganan SigV4; terdeteksi secara otomatis dari nama host titik akhir jika tidak disediakan.
Contoh: `--service ecs-mcp`
**--profil** (opsional)
AWS profil kredensyal untuk digunakan. Default ke variabel `AWS_PROFILE` lingkungan jika tidak ditentukan.
Contoh: `--profile dev`
**--wilayah**
AWS wilayah untuk digunakan. Menggunakan variabel `AWS_REGION` lingkungan jika tidak disetel, defaultnya. `us-east-1`
Contoh: `--region us-west-2`
**--read-only (opsional**)
Nonaktifkan alat yang mungkin memerlukan izin menulis (alat yang TIDAK memerlukan izin menulis dianotasi). `readOnlyHint=true` Secara default, semua alat diaktifkan.
Contoh: `--read-only`
Untuk opsi konfigurasi lainnya, lihat [Parameter konfigurasi](https://github.com/aws/mcp-proxy-for-aws?tab=readme-ov-file#configuration-parameters).
## Alat
[Server Amazon ECS MCP memperlihatkan alat MCP berikut.](https://modelcontextprotocol.io/specification/2025-06-18/server/tools)
### Hanya baca alat
**get\_deployment\_status**
Alat ini memeriksa status penerapan Amazon ECS Anda untuk kluster dan layanan Amazon ECS tertentu.
+ Tindakan IAM yang diperlukan:
+ `ecs:DescribeServices`
+ `elasticloadbalancing:DescribeTargetGroups`
+ `elasticloadbalancing:DescribeLoadBalancers`
+ Parameter yang diperlukan:
+ `cluster_name`(string): Nama cluster Amazon ECS
+ `service_name`(string): Nama layanan Amazon ECS
+ Respons: Alat ini mengembalikan status penerapan dan detail yang terkait dengan penerapan.
**fetch\_service\_events**
Alat ini mengambil peristiwa layanan Amazon ECS untuk diagnostik dengan jendela waktu yang dapat disesuaikan.
+ Tindakan IAM yang diperlukan:
+ `ecs:DescribeServices`
+ Parameter yang diperlukan:
+ `cluster_name`(string): Nama cluster Amazon ECS
+ `service_name`(string): Nama layanan Amazon ECS
+ Parameter opsional:
+ `time_window`(integer): Anda dapat menyebutkan jendela waktu dalam hitungan detik (default adalah 1 jam atau 3600 detik)
+ `start_time`(string): Waktu mulai khusus dalam format ISO
+ `end_time`(string): Waktu akhir khusus dalam format ISO
+ Respons: Alat ini mengembalikan daftar acara untuk layanan dengan ringkasan.
**fetch\_task\_failure**
Alat ini membantu Anda mengambil dan menganalisis kegagalan tugas Amazon ECS dengan ringkasan. Dengan menggunakan alat ini, Anda dapat mengidentifikasi pola apa pun dalam kegagalan tugas.
+ Tindakan IAM yang diperlukan:
+ `ecs:ListTasks`
+ `ecs:DescribeTasks`
+ Parameter yang diperlukan:
+ `cluster_name`(string): Nama cluster Amazon ECS tempat tugas Anda berada
+ Parameter opsional:
+ `service_name`(string): Anda dapat memfilter berdasarkan layanan tertentu
+ `time_window`(integer): Anda dapat menyebutkan jendela waktu dalam hitungan detik (default adalah 1 jam atau 3600 detik)
+ `start_time`(string): Waktu mulai khusus dalam format ISO
+ `end_time`(string): Waktu akhir khusus dalam format ISO
+ Respons: Alat ini kembali TaskFailureResult dengan tugas dan ringkasan yang gagal
**fetch\_task\_logs**
Alat ini mengambil CloudWatch log untuk tugas Amazon ECS dengan opsi rentang waktu yang fleksibel. Anda menggunakan alat ini untuk memecahkan masalah runtime.
+ Tindakan IAM yang diperlukan:
+ `ecs:DescribeServices`
+ `ecs:DescribeTaskDefinition`
+ `logs:FilterLogEvents`
+ Parameter yang diperlukan:
+ `cluster_name`(string): Nama cluster Amazon ECS
+ `service_name`(string): Nama layanan Amazon ECS
+ Parameter opsional:
+ `time_window`(integer): Anda dapat menyebutkan jendela waktu dalam hitungan detik (default adalah 1 jam atau 3600 detik)
+ `start_time`(string): Waktu mulai khusus dalam format ISO
+ `end_time`(string): Waktu akhir khusus dalam format ISO
+ `log_group_name`(string): Tentukan grup CloudWatch log
+ Respon: Alat ini kembali TaskLogsResult dengan entri log
**get\_task\_definition\_deletion\_blockers**
Alat ini mengidentifikasi dependensi yang dapat mencegah penghapusan definisi tugas. Alat ini sesuai saat Anda menjalankan operasi pembersihan dan memahami apa yang mencegah penghapusan sumber daya Amazon ECS.
+ Tindakan IAM yang diperlukan:
+ `ecs:ListClusters`
+ `ecs:ListServices`
+ `ecs:DescribeServices`
+ `ecs:ListTasks`
+ `ecs:DescribeTasks`
+ Parameter yang diperlukan:
+ `task_definition_arn`(string): Definisi tugas Nama Sumber Daya Amazon (ARN) untuk dianalisis
+ Respon: Alat mengembalikan blocker dan status penghapusan
**detect\_image\_pull\_failure**
Alat ini membantu Anda mendeteksi dan mengkategorikan kegagalan penarikan gambar kontainer.
+ Tindakan IAM yang diperlukan:
+ `ecs:ListTasks`
+ `ecs:DescribeTasks`
+ Parameter yang diperlukan:
+ `cluster_name`(string): Nama cluster Amazon ECS
+ Parameter opsional:
+ `service_name`(string): Anda dapat memfilter berdasarkan layanan tertentu
+ `time_window`(integer): Anda dapat menyebutkan jendela waktu dalam hitungan detik (default adalah 1 jam atau 3600 detik)
+ `start_time`(string): Waktu mulai khusus dalam format ISO
+ `end_time`(string): Waktu akhir khusus dalam format ISO
+ Respons: Alat mengembalikan kegagalan dan ringkasan
**fetch\_network\_configuration**
Alat ini mengambil detail konfigurasi jaringan layanan Amazon ECS. Anda dapat menggunakan alat ini untuk memahami konfigurasi Amazon VPC, subnet, grup keamanan pengaturan Amazon ECS Anda.
+ Tindakan IAM yang diperlukan:
+ `ecs:DescribeServices`
+ `ec2:DescribeSecurityGroups`
+ `ec2:DescribeSubnets`
+ Parameter yang diperlukan:
+ `cluster_name`(string): Nama cluster Amazon ECS
+ `service_name`(string): Nama layanan Amazon ECS
+ Respon: Alat ini mengembalikan daftar NetworkConfigurationResult dengan rincian jaringan
**get\_security\_recommendations**
Alat ini mengumpulkan data konfigurasi keamanan klaster Amazon ECS untuk analisis AI-powered keamanan. Ini mengumpulkan peran dan kebijakan IAM, pengaturan jaringan (grup keamanan, subnet, IP publik), pengaturan wadah definisi tugas, dan konfigurasi tingkat cluster. Asisten AI Anda membandingkan data ini dengan praktik terbaik AWS keamanan dan menghasilkan laporan temuan yang diprioritaskan dengan langkah-langkah perbaikan.
+ Tindakan IAM yang diperlukan:
+ `ecs:DescribeClusters`
+ `ecs:ListServices`
+ `ecs:DescribeServices`
+ `ecs:DescribeTaskDefinition`
+ `ec2:DescribeSecurityGroups`
+ `ec2:DescribeSubnets`
+ `iam:GetRole`
+ `iam:ListAttachedRolePolicies`
+ `iam:GetPolicy`
+ `iam:GetPolicyVersion`
+ `iam:ListRolePolicies`
+ `iam:GetRolePolicy`
+ Parameter yang diperlukan:
+ `cluster_name`(string): Nama cluster Amazon ECS untuk dianalisis
+ Parameter opsional:
+ `service_name`(string): Analisis lingkup untuk satu layanan. Jika dihilangkan, semua layanan di cluster dianalisis.
+ `max_services`(integer): Jumlah maksimum layanan untuk dianalisis (default 25, dibatasi pada 50)
+ Respons: Alat ini mengembalikan konfigurasi cluster, konfigurasi layanan, pengaturan definisi tugas, detail keamanan jaringan, peran IAM dan data kebijakan, dan peringatan pengumpulan apa pun. Asisten AI Anda menggunakan data ini untuk menghasilkan laporan temuan keamanan yang diprioritaskan dengan panduan remediasi.
### Alat pengetahuan
Alat-alat ini menyediakan akses ke AWS dokumentasi terkini. Mereka didukung oleh AWS Knowledge MCP Server dan tidak memerlukan izin IAM dari penelepon - layanan Amazon ECS MCP terhubung ke titik akhir pengetahuan atas nama Anda.
**aws\_knowledge\_aws\_\_\_search\_documentation**
Alat ini mencari AWS dokumentasi untuk halaman yang relevan yang cocok dengan kueri.
+ Tindakan IAM yang diperlukan: Tidak ada
+ Parameter yang diperlukan:
+ `search_phrase`(string): Permintaan pencarian untuk AWS dokumentasi
+ Parameter opsional:
+ `topics`(array): Hingga 3 area topik untuk dicari (default`["general"]`)
+ `limit`(bilangan bulat): Jumlah maksimum hasil per topik (default 5)
+ Tanggapan: Alat ini mengembalikan halaman dokumentasi yang cocok dengan judul, URL, dan cuplikan konteks.
**aws\_knowledge\_aws\_\_\_read\_documentation**
Alat ini membaca konten halaman AWS dokumentasi dan mengembalikannya dalam format penurunan harga.
+ Tindakan IAM yang diperlukan: Tidak ada
+ Parameter yang diperlukan:
+ `requests`(array): Array objek permintaan. Setiap objek berisi:
+ `url`(string, wajib): URL halaman dokumentasi untuk dibaca
+ `max_length`(integer, opsional): Karakter maksimum untuk kembali (default 10000)
+ `start_index`(integer, opsional): Posisi karakter untuk mulai membaca dari (default 0)
+ Tanggapan: Alat ini mengembalikan konten halaman dokumentasi dalam format penurunan harga. Halaman panjang dikembalikan dalam potongan dengan dukungan navigasi.
**aws\_knowledge\_aws\_\_\_recommend**
Alat ini mengembalikan halaman dokumentasi terkait untuk URL AWS dokumentasi yang diberikan.
+ Tindakan IAM yang diperlukan: Tidak ada
+ Parameter yang diperlukan:
+ `url`(string): URL AWS dokumentasi (harus berupa halaman docs.aws.amazon.com)
+ Tanggapan: Alat ini memberikan rekomendasi untuk halaman AWS dokumentasi terkait di empat kategori: populer, baru, serupa, dan umum dibaca berikutnya.