Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 12 additions & 2 deletions src/ecs-mcp-server/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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:

Expand All @@ -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
Expand Down
2 changes: 2 additions & 0 deletions src/ecs-mcp-server/pyproject.toml
Original file line number Diff line number Diff line change
Expand Up @@ -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/"
Expand Down
60 changes: 60 additions & 0 deletions src/ecs-mcp-server/server.json
Original file line number Diff line number Diff line change
@@ -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"
}
Loading