MCP服务器

基于TypeScript的MCP服务器,运行在Amazon Bedrock AgentCore运行时环境上,用于模型上下文协议的处理。

  • by megandsouza03
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 megandsouza03/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权限 在代理沙盒中部署和测试
  2. 获取在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