View a markdown version of this page

Konfigurasi Alat Server MCP Amazon ECS - Amazon Elastic Container Service
Variabel-variabel lingkunganArgumenAlat

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

Konfigurasi Alat Server MCP Amazon ECS

Panduan ini menunjukkan semua konfigurasi yang tersedia untuk Server MCP Amazon ECS yang dikelola sepenuhnya.

catatan

Server Amazon ECS MCP sedang dalam rilis pratinjau dan dapat berubah.

Variabel-variabel lingkungan

AWS_PROFILE (opsional)

AWS nama profil kredenSIAL untuk digunakan; dapat diganti oleh argumen baris perintah--profile.

Contoh: export AWS_PROFILE=dev

AWS_REGION (opsional)

AWS wilayah untuk penandatanganan SIGv4; default ke us-west-2 jika tidak disetel.

Contoh: export AWS_REGION=us-west-2

Argumen

URL titik akhir MCP SIGv4 (wajib)

URL titik akhir MCP untuk terhubung.

Contoh: https://ecs-mcp.us-west-2.api.aws/mcp

--layanan (opsional)

AWS nama layanan untuk penandatanganan SIGv4; terdeteksi otomatis dari nama host titik akhir jika tidak disediakan.

Contoh: --service ecs-mcp

--profil (opsional)

AWS profil kredenSIAL untuk digunakan. Defaultnya adalah variabel AWS_PROFILE lingkungan jika tidak ditentukan.

Contoh: --profile dev

--wilayah

AWS wilayah untuk digunakan. Menggunakan variabel AWS_REGION lingkungan jika tidak disetel, default keus-east-1.

Contoh: --region us-west-2

--read-only (opsional)

Nonaktifkan alat yang mungkin memerlukan izin menulis (alat yang TIDAK memerlukan izin menulis dianotasi denganreadOnlyHint=true). Secara default, semua alat diaktifkan.

Contoh: --read-only

Untuk opsi konfigurasi lainnya, lihat Param eter konfigurasi.

Alat

Server Amazon ECS MCP mengekspos alat MCP berikut.

Alat baca saja

dapatkan_penerapan_status

Alat ini memeriksa status penerapan Amazon ECS Anda untuk cluster 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

  • Tanggapan: Alat mengembalikan status penerapan dan detail yang terkait dengan penerapan.

ambilkan_layan_acara-acara

Alat ini mengambil acara 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 detik (default adalah 1 jam atau 3600 detik)

    • start_time(string): Waktu mulai kustom dalam format ISO

    • end_time(string): Waktu akhir khusus dalam format ISO

  • Tanggapan: Alat mengembalikan daftar peristiwa untuk layanan dengan ringkasan.

fetch_tugas_kegagalan

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 detik (default adalah 1 jam atau 3600 detik)

    • start_time(string): Waktu mulai kustom dalam format ISO

    • end_time(string): Waktu akhir khusus dalam format ISO

  • Tanggapan: Alat kembali TaskFailureResult dengan tugas dan ringkasan yang gagal

ambilkan_tugas_log

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 detik (default adalah 1 jam atau 3600 detik)

    • start_time(string): Waktu mulai kustom dalam format ISO

    • end_time(string): Waktu akhir khusus dalam format ISO

    • log_group_name(string): Tentukan grup CloudWatch log

  • Tanggapan: Alat kembali TaskLogsResult dengan entri log

get_task_definition_deletion_blocker

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

  • Tanggapan: Alat mengembalikan status pemblokir dan penghapusan

deteksi_image_pull_kegagalan

Alat ini membantu Anda mendeteksi dan mengkategorikan kegagalan tarik 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 detik (default adalah 1 jam atau 3600 detik)

    • start_time(string): Waktu mulai kustom dalam format ISO

    • end_time(string): Waktu akhir khusus dalam format ISO

  • Tanggapan: 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 dari 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

  • Tanggapan: Alat mengembalikan daftar NetworkConfigurationResult dengan detail jaringan

dapatkan_security_rekomendasi

Alat ini mengumpulkan data konfigurasi keamanan cluster 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 prioritas dengan langkah-langkah remediasi.

  • 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 dalam cluster dianalisis.

    • max_services(integer): Jumlah maksimum layanan untuk dianalisis (default 25, dibatasi pada 50)

  • Tanggapan: Alat 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.

ambilkan_log_aksi

Gunakan alat ini untuk mengambil Log Aksi Amazon ECS dan memecahkan masalah operasi siklus hidup kontainer. Dengan Log Aksi, Anda mendapatkan visibilitas ke dalam operasi sisi layanan yang dilakukan Amazon ECS atas nama Anda, termasuk lampiran ENI, penarikan gambar, pendaftaran penyeimbang beban, percobaan ulang pembatasan, dan kesalahan izin. Gunakan alat ini ketika tugas gagal dimulai, penerapan terhenti, atau Anda perlu memahami apa yang dilakukan Amazon ECS selama operasi. Alat mengembalikan entri log tindakan jika Log Tindakan diaktifkan untuk cluster, atau pesan status jika Log Tindakan tidak dikonfigurasi.

  • Tindakan IAM yang diperlukan:

    • ecs:DescribeClusters

    • logs:DescribeDeliverySources

    • logs:DescribeDeliveries

    • logs:DescribeDeliveryDestinations

    • logs:FilterLogEvents

  • Parameter yang diperlukan:

    • cluster_name: Nama atau ARN dari cluster Amazon ECS.

  • Parameter opsional:

    • service_name: Nama layanan Amazon ECS untuk memfilter log tindakan berdasarkan.

    • task_id: Tugas ARN atau ID untuk memfilter log tindakan berdasarkan.

    • deployment_id: ID penerapan untuk memfilter log tindakan berdasarkan.

    • log_level: Filter tingkat log. Nilai yang valid adalah ERROR, WARN, atau INFO.

    • time_window: Jendela waktu dalam detik. Nilai defaultnya adalah 3.600 detik.

    • start_time: Waktu mulai kustom dalam format ISO.

    • end_time: Waktu akhir kustom dalam format ISO.

  • Respons:

    Alat mengembalikan status penemuan log tindakan untuk cluster. Jika Log Aksi diaktifkan dengan tujuan CloudWatch Logs, alat ini juga mengembalikan entri log yang cocok. Setiap entri menyertakan stempel waktu, tingkat log, nama acara, ARN sumber daya, dan detail acara. Hasil dibatasi hingga 1.000 entri. Untuk mengambil data yang lebih ditargetkan, gunakan jendela waktu yang lebih sempit atau filter tambahan.

Alat pengetahuan

Alat-alat ini menyediakan akses ke AWS dokumentasi terkini. Mereka didukung oleh Kno AWS wledge MCP Server dan tidak memerlukan izin IAM apa pun dari pemanggil — layanan Amazon ECS MCP terhubung ke titik akhir pengetahuan atas nama Anda.

aws_know_aws___penelusuran_dokumentasi

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): Cari kueri untuk AWS dokumentasi

  • Parameter opsional:

    • topics(array): Hingga 3 area topik untuk dicari (default["general"])

    • limit(integer): Jumlah maksimum hasil per topik (default 5)

  • Tanggapan: Alat mengembalikan halaman dokumentasi yang cocok dengan judul, URL, dan cuplikan konteks.

aws_know_aws___baca_dokumentasi

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 dikembalikan (default 10000)

      • start_index(integer, opsional): Posisi karakter untuk mulai membaca dari (default 0)

  • Tanggapan: Alat mengembalikan konten halaman dokumentasi dalam format penurunan harga. Halaman panjang dikembalikan dalam potongan dengan dukungan navigasi.