Typescript MCP Server On Aws Agentcore Runtime

关于

GitHub存储库托管了一个基于TypeScript的MCP（模型上下文协议）服务器，该服务器在Amazon Bedrock AgentCore运行时环境中运行。

先决条件

• Node.js v22+
• Docker用于容器化
• 用于存储Docker镜像的ECR存储库
• Bedrock Agentcore的AWS帐户

理解AgentCore运行时服务契约

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

• 主机：0.0.0.0
• 端口：8000
• 传输：无状态流式传输http
• 路径要求： /mcp -职位

地方发展

1. 安装依赖项

npm install

1. 设置AWS凭据

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

1. 启动服务器

npm run start

1. 使用本地测试 MCP检查员

npx @modelcontextprotocol/inspector

Docker部署

1. 创建ECR存储库

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

1. 构建图像并将其推送到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 .

1. 部署到基岩代理核心

- 打开基岩控制台→ 代理核心→ 创建代理 - 为协议选择MCP - 配置代理运行时： - 映像URI:\[帐户id\].dkr.ecr.us-east-1.amazonaws.com/mcp服务器：最新 - 设置基岩模型访问的IAM权限 在代理沙盒中部署和测试

1. 获取在agentcore运行时上运行的MCP服务器的编码ARN MCP url

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

mcp_url=“https://bedrock-agentcore.{region}.amazonaws.com/运行时/{encoded_arn}/调用？限定符=默认值”

1. 使用MCP url MCP检查员.

参考文献

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