Skip to content

Commit f5a188d

Browse files
author
Alex Dudarenko
committed
feat(ecs-mcp-server): add hosted MCP server documentation and registry metadata
1 parent d6344f8 commit f5a188d

File tree

3 files changed

+107
-2
lines changed

3 files changed

+107
-2
lines changed

src/ecs-mcp-server/README.md

Lines changed: 45 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,50 @@ Customers can list and view their ECS resources (clusters, services, tasks, task
2727

2828
## Installation
2929

30-
### Prerequisites
30+
### Option 1 (Recommended): Hosted MCP Server
31+
32+
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.
33+
34+
#### Prerequisites
35+
36+
- [Python 3.10+](https://www.python.org/downloads/release/python-3100/) and [uv package manager](https://docs.astral.sh/uv/getting-started/installation/)
37+
- [AWS CLI configured](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html) with valid credentials
38+
- IAM permissions for ECS MCP
39+
40+
#### Configuration
41+
42+
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:
43+
44+
**For Mac/Linux:**
45+
```json
46+
{
47+
"mcpServers": {
48+
"ecs-mcp": {
49+
"disabled": false,
50+
"type": "stdio",
51+
"command": "uvx",
52+
"args": [
53+
"mcp-proxy-for-aws@latest",
54+
"https://ecs-mcp.us-east-1.api.aws/mcp",
55+
"--profile",
56+
"default",
57+
"--region",
58+
"us-east-1"
59+
]
60+
}
61+
}
62+
}
63+
```
64+
65+
Replace `us-east-1` with your desired AWS region and `default` with your AWS CLI profile name.
66+
67+
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).
68+
69+
### Option 2: Local MCP Server (Legacy)
70+
71+
> **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.
72+
73+
#### Prerequisites
3174

3275
Before installing the ECS MCP Server, ensure you have the following prerequisites installed:
3376

@@ -38,7 +81,7 @@ Before installing the ECS MCP Server, ensure you have the following prerequisite
3881
2. **UV**: Required for package management and running MCP servers
3982
- Install `uv` from [Astral](https://docs.astral.sh/uv/getting-started/installation/)
4083

41-
### Installation Steps
84+
#### Installation Steps
4285

4386
```bash
4487
# Install using uv

src/ecs-mcp-server/pyproject.toml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -42,6 +42,8 @@ dev = [
4242
"ruff>=0.11.11",
4343
]
4444

45+
hosted = ["mcp-proxy-for-aws>=1.1.1"]
46+
4547
[project.urls]
4648
Homepage = "https://github.com/awslabs/mcp"
4749
Documentation = "https://awslabs.github.io/mcp/servers/ecs-mcp-server/"

src/ecs-mcp-server/server.json

Lines changed: 60 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,60 @@
1+
{
2+
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-10-17/server.schema.json",
3+
"description": "AI-powered Amazon ECS cluster management and troubleshooting",
4+
"name": "io.github.awslabs/ecs-mcp-server",
5+
"packages": [
6+
{
7+
"identifier": "mcp-proxy-for-aws",
8+
"packageArguments": [
9+
{
10+
"type": "positional",
11+
"value": "https://ecs-mcp.{region}.api.aws/mcp",
12+
"variables": {
13+
"region": {
14+
"default": "us-east-1",
15+
"description": "AWS region for ECS MCP service",
16+
"isRequired": true
17+
}
18+
}
19+
},
20+
{
21+
"name": "--service",
22+
"type": "named",
23+
"value": "ecs-mcp"
24+
},
25+
{
26+
"default": "default",
27+
"description": "AWS CLI profile to use for credentials",
28+
"name": "--profile",
29+
"type": "named"
30+
},
31+
{
32+
"name": "--region",
33+
"type": "named",
34+
"value": "{region}",
35+
"variables": {
36+
"region": {
37+
"default": "us-east-1",
38+
"description": "AWS region"
39+
}
40+
}
41+
}
42+
],
43+
"registryBaseUrl": "https://pypi.org",
44+
"registryType": "pypi",
45+
"runtimeHint": "uvx",
46+
"transport": {
47+
"type": "stdio"
48+
},
49+
"version": "1.1.1"
50+
}
51+
],
52+
"repository": {
53+
"source": "github",
54+
"subfolder": "src/ecs-mcp-server",
55+
"url": "https://github.com/awslabs/mcp"
56+
},
57+
"title": "Amazon ECS MCP Server",
58+
"version": "1.0.0",
59+
"websiteUrl": "https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-mcp-getting-started.html"
60+
}

0 commit comments

Comments
 (0)