diff --git a/src/ecs-mcp-server/README.md b/src/ecs-mcp-server/README.md index 15794f6f9c..cdbaab07f6 100644 --- a/src/ecs-mcp-server/README.md +++ b/src/ecs-mcp-server/README.md @@ -27,7 +27,17 @@ 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. + +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) + +> **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 +48,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..a433c3a7bb --- /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": "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" +}