About

GitHub repository hosts a TypeScript-based MCP (Model Context Protocol) server running on the Amazon Bedrock AgentCore runtime environment.

Prerequisites

• Node.js v22+
• Docker for containerization
• ECR Repository for storing your Docker image
• AWS Account with Bedrock Agentcore

Understanding the AgentCore Runtime service contract

https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/runtime-service-contract.html

• Host: 0.0.0.0
• Port: 8000
• Transport: Stateless streamable-http
• Path requirements: /mcp - POST

Local Development

1. Install dependencies

npm install

2. Set up AWS credentials

aws configure
export AWS_ACCESS_KEY_ID=your_access_key
export AWS_SECRET_ACCESS_KEY=your_secret_key
export AWS_REGION=us-east-1

3. Start server

npm run start

4. Test locally using MCP inspector

npx @modelcontextprotocol/inspector

Docker Deployment

1. Create ECR Repository

aws ecr create-repository --repository-name mcp-server --region us-east-1

2. Build and Push Image to ECR

# Get login token
aws ecr get-login-password --region us-east-1 | \
  docker login --username AWS --password-stdin [account-id].dkr.ecr.us-east-1.amazonaws.com

docker buildx --platform linux/arm64 \
  -t [account-id].dkr.ecr.us-east-1.amazonaws.com/mcp-server:latest --push .

3. Deploy to Bedrock Agent Core

   • Open Bedrock Console → Agent Core → Create Agent
   • Select MCP for the protocol
   • Configure Agent Runtime:
     • Image URI: [account-id].dkr.ecr.us-east-1.amazonaws.com/mcp-server:latest
     • Set IAM Permissions for Bedrock model access Deploy and test in the Agent Sandbox

4. Obtain encoded ARN MCP url of the MCP server running on agentcore runtime

echo "agent_arn" | sed 's/:/%3A/g; s/\//%2F/g'

mcp_url = "https://bedrock-agentcore.{region}.amazonaws.com/runtimes/{encoded_arn}/invocations?qualifier=DEFAULT"

5. Use the MCP url with MCP inspector.

References

• https://aws.amazon.com/bedrock/agentcore/
• https://github.com/modelcontextprotocol/typescript-sdk
• https://github.com/modelcontextprotocol/inspector