Registry / aws / awslabs-ecs-mcp-server

awslabs-ecs-mcp-server

library0.1.28pypypiunverified

An MCP (Model Context Protocol) server that automates containerization and deployment of web applications to AWS ECS. Version 0.1.28, requires Python >=3.10.

aws devops llm-agents

pip install awslabs-ecs-mcp-server

github ↗package ↗docs ↗

INSTALL

IMPORT

SIG · AWSLABS-ECS-MCP-SE

awslabs-ecs-mcp-server

awspythonv0.1.28

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

ECSMCPApplication

✓ from awslabs.ecs_mcp_server import ECSMCPApplication

✗ import ecs_mcp_server

ECSMCPDeployer

✓ from awslabs.ecs_mcp_server import ECSMCPDeployer

✗ import ecs_mcp_server

ECSMCPConfig

✓ from awslabs.ecs_mcp_server import ECSMCPConfig

✗ import ecs_mcp_server

Minimal example to start the ECS MCP server. Ensure AWS credentials are configured.

import os from ecs_mcp_server import app # Requires AWS credentials (AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_REGION) # and AWS_PROFILE or environment variables. os.environ.setdefault('AWS_REGION', 'us-east-1') # Run the MCP server (uses stdio transport by default) app.run()

ecs-mcp-server --version

Debug

Known issues

gotchaThe server requires AWS credentials and appropriate IAM permissions (ecs:*). Common mistake: missing IAM roles leads to cryptic boto3 errors.

fix

Set AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, and AWS_REGION environment variables or use a valid AWS profile.

affects: all

gotchaThe server uses stdio transport by default and is intended to be used with an MCP client (e.g., Claude Desktop, VS Code extension). Running standalone without a client does nothing visible.

fix

Configure an MCP client to launch the server via `mcp install awslabs-ecs-mcp-server` or point to the script.

affects: all

deprecatedSome tools (e.g., deploy) may rely on Docker being installed locally. If Docker is not available, the server errors.

fix

Ensure Docker is installed and running, or use the '--platform' flag if supported.

affects: <=0.1.28

Upgrade

Version history

0.1.28latest on PyPI · released Mar 27, 2026

Audit

Dependencies

No dependency data recorded yet.

Agent activity

25 hits · last 30 days

node

Amazon

OpenAI (training)

Resources

githubhttps://github.com/awslabs/mcp ↗

packagehttps://pypi.org/project/awslabs-ecs-mcp-server/ ↗

docshttps://awslabs.github.io/mcp/servers/ecs-mcp-server/ ↗