From 02abee0bc73ae6b250114b40c770b862d2ccc704 Mon Sep 17 00:00:00 2001 From: Alex Dudarenko Date: Wed, 3 Dec 2025 13:50:31 -0800 Subject: [PATCH 1/2] feat(ecs-mcp-server): add hosted MCP server documentation and registry metadata. --- src/ecs-mcp-server/README.md | 47 ++++++++++++++++++++++-- src/ecs-mcp-server/pyproject.toml | 2 ++ src/ecs-mcp-server/server.json | 60 +++++++++++++++++++++++++++++++ 3 files changed, 107 insertions(+), 2 deletions(-) create mode 100644 src/ecs-mcp-server/server.json diff --git a/src/ecs-mcp-server/README.md b/src/ecs-mcp-server/README.md index 15794f6f9c..8998178509 100644 --- a/src/ecs-mcp-server/README.md +++ b/src/ecs-mcp-server/README.md @@ -27,7 +27,50 @@ Customers can list and view their ECS resources (clusters, services, tasks, task ## Installation -### Prerequisites +### Option 1 (Recommended): Hosted MCP Server + +Use the AWS-managed ECS MCP Server for simplified setup and automatic updates. The hosted service eliminates local installation requirements and provides enterprise-grade security through AWS IAM integration. + +#### Prerequisites + +- [Python 3.10+](https://www.python.org/downloads/release/python-3100/) and [uv package manager](https://docs.astral.sh/uv/getting-started/installation/) +- [AWS CLI configured](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html) with valid credentials +- IAM permissions for ECS MCP + +#### Configuration + +The hosted ECS MCP Server uses the [MCP Proxy for AWS](https://github.com/aws/mcp-proxy-for-aws) to provide secure, authenticated access. Add the following to your MCP client configuration file: + +**For Mac/Linux:** +```json +{ + "mcpServers": { + "ecs-mcp": { + "disabled": false, + "type": "stdio", + "command": "uvx", + "args": [ + "mcp-proxy-for-aws@latest", + "https://ecs-mcp.us-east-1.api.aws/mcp", + "--profile", + "default", + "--region", + "us-east-1" + ] + } + } +} +``` + +Replace `us-east-1` with your desired AWS region and `default` with your AWS CLI profile name. + +For complete setup instructions and additional configuration options, see the [Amazon ECS MCP Server documentation](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-mcp-getting-started.html). + +### Option 2: Local MCP Server (Legacy) + +> **Note**: This is the legacy local installation method that will no longer receive updates. We recommend using [Option 1 (Hosted MCP Server)](#option-1-recommended-hosted-mcp-server) instead. + +#### Prerequisites Before installing the ECS MCP Server, ensure you have the following prerequisites installed: @@ -38,7 +81,7 @@ Before installing the ECS MCP Server, ensure you have the following prerequisite 2. **UV**: Required for package management and running MCP servers - Install `uv` from [Astral](https://docs.astral.sh/uv/getting-started/installation/) -### Installation Steps +#### Installation Steps ```bash # Install using uv diff --git a/src/ecs-mcp-server/pyproject.toml b/src/ecs-mcp-server/pyproject.toml index e315368ff3..9174c8e2db 100644 --- a/src/ecs-mcp-server/pyproject.toml +++ b/src/ecs-mcp-server/pyproject.toml @@ -42,6 +42,8 @@ dev = [ "ruff>=0.11.11", ] +hosted = ["mcp-proxy-for-aws>=1.1.1"] + [project.urls] Homepage = "https://github.com/awslabs/mcp" Documentation = "https://awslabs.github.io/mcp/servers/ecs-mcp-server/" diff --git a/src/ecs-mcp-server/server.json b/src/ecs-mcp-server/server.json new file mode 100644 index 0000000000..069d5f05d0 --- /dev/null +++ b/src/ecs-mcp-server/server.json @@ -0,0 +1,60 @@ +{ + "$schema": "https://static.modelcontextprotocol.io/schemas/2025-10-17/server.schema.json", + "description": "AI-powered Amazon ECS cluster management and troubleshooting", + "name": "io.github.awslabs/ecs-mcp-server", + "packages": [ + { + "identifier": "mcp-proxy-for-aws", + "packageArguments": [ + { + "type": "positional", + "value": "https://ecs-mcp.{region}.api.aws/mcp", + "variables": { + "region": { + "default": "us-east-1", + "description": "AWS region for ECS MCP service", + "isRequired": true + } + } + }, + { + "name": "--service", + "type": "named", + "value": "ecs-mcp" + }, + { + "default": "default", + "description": "AWS CLI profile to use for credentials", + "name": "--profile", + "type": "named" + }, + { + "name": "--region", + "type": "named", + "value": "{region}", + "variables": { + "region": { + "default": "us-east-1", + "description": "AWS region" + } + } + } + ], + "registryBaseUrl": "https://pypi.org", + "registryType": "pypi", + "runtimeHint": "uvx", + "transport": { + "type": "stdio" + }, + "version": "1.1.1" + } + ], + "repository": { + "source": "github", + "subfolder": "src/ecs-mcp-server", + "url": "https://github.com/awslabs/mcp" + }, + "title": "Amazon ECS MCP Server", + "version": "1.0.0", + "websiteUrl": "https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-mcp-getting-started.html" +} From 9f1c06677572d379da1352e2cf639b8c25009dd2 Mon Sep 17 00:00:00 2001 From: Alex Dudarenko Date: Wed, 3 Dec 2025 14:49:36 -0800 Subject: [PATCH 2/2] code review feedback --- src/ecs-mcp-server/README.md | 35 +--------------------------------- src/ecs-mcp-server/server.json | 2 +- 2 files changed, 2 insertions(+), 35 deletions(-) diff --git a/src/ecs-mcp-server/README.md b/src/ecs-mcp-server/README.md index 8998178509..cdbaab07f6 100644 --- a/src/ecs-mcp-server/README.md +++ b/src/ecs-mcp-server/README.md @@ -31,40 +31,7 @@ Customers can list and view their ECS resources (clusters, services, tasks, task Use the AWS-managed ECS MCP Server for simplified setup and automatic updates. The hosted service eliminates local installation requirements and provides enterprise-grade security through AWS IAM integration. -#### Prerequisites - -- [Python 3.10+](https://www.python.org/downloads/release/python-3100/) and [uv package manager](https://docs.astral.sh/uv/getting-started/installation/) -- [AWS CLI configured](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html) with valid credentials -- IAM permissions for ECS MCP - -#### Configuration - -The hosted ECS MCP Server uses the [MCP Proxy for AWS](https://github.com/aws/mcp-proxy-for-aws) to provide secure, authenticated access. Add the following to your MCP client configuration file: - -**For Mac/Linux:** -```json -{ - "mcpServers": { - "ecs-mcp": { - "disabled": false, - "type": "stdio", - "command": "uvx", - "args": [ - "mcp-proxy-for-aws@latest", - "https://ecs-mcp.us-east-1.api.aws/mcp", - "--profile", - "default", - "--region", - "us-east-1" - ] - } - } -} -``` - -Replace `us-east-1` with your desired AWS region and `default` with your AWS CLI profile name. - -For complete setup instructions and additional configuration options, see the [Amazon ECS MCP Server documentation](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-mcp-getting-started.html). +For complete setup instructions, configuration examples, and IAM permissions, see the [Amazon ECS MCP Server documentation](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-mcp-getting-started.html). ### Option 2: Local MCP Server (Legacy) diff --git a/src/ecs-mcp-server/server.json b/src/ecs-mcp-server/server.json index 069d5f05d0..a433c3a7bb 100644 --- a/src/ecs-mcp-server/server.json +++ b/src/ecs-mcp-server/server.json @@ -1,6 +1,6 @@ { "$schema": "https://static.modelcontextprotocol.io/schemas/2025-10-17/server.schema.json", - "description": "AI-powered Amazon ECS cluster management and troubleshooting", + "description": "Amazon ECS cluster management and troubleshooting", "name": "io.github.awslabs/ecs-mcp-server", "packages": [ {