AgentCore와 로컬 MCP 도구를 연결하는 MCP 브리지

{
  "name": "com.example.mcp_bridge",
  "description": "MCP Bridge - Routes MCP messages to local servers",
  "path": "/path/to/mcp-bridge-demo/bridge/run_bridge.sh",
  "type": "stdio",
  "allowed_origins": [
    "chrome-extension:///"
  ]
}

이 JSON 매니페스트는 Chrome의 Native Messaging 호스트 등록에 사용되는 파일로, 브라우저가 확장을 통해 로컬 브리지 바이너리를 실행하도록 매핑한다. 매니페스트는 실행 경로와 stdio 통신 타입, 허용된 확장 ID를 포함하므로 브리지 프로세스가 확장으로부터만 호출되게 제한하는 초권한 제어가 가능하다. 매니페스트를 올바른 위치에 설치해야 브라우저가 연결 시 호스트를 자동으로 시작한다.

#!/bin/bash
cd "/path/to/mcp-bridge-demo/bridge"
source .venv/bin/activate
exec python3 bridge.py

run_bridge.sh은 매니페스트가 가리키는 런처 스크립트로, 가상환경을 활성화한 뒤 브리지 파이썬 프로세스를 실행한다. 이 스크립트가 있으면 사용자가 별도 Python 설치나 수동 환경 설정 없이 확장이 브리지 프로세스를 시작할 수 있다. 프로덕션에서는 이 스크립트를 대신 독립 실행 파일을 가리키도록 매니페스트를 변경하는 것이 권장된다.

{
  "mcpServers": {
    "excel": {
      "command": "python3",
      "args": ["excel_server.py"]
    }
  }
}

mcp.json은 브리지가 시작 시 자식 프로세스로 실행할 로컬 MCP 서버를 구성하는 간단한 설정 파일이다. 서버 명과 실행 명령을 지정하면 브리지가 생애주기 동안 해당 프로세스를 유지해 요청당 프로세스 생성 오버헤드를 제거한다. 신규 도구를 추가할 때 이 파일에 한 줄을 추가하면 브리지를 다시 빌드하지 않고도 서버를 연결할 수 있다.

git clone https://github.com/aws-samples/sample-mcp-bridge-agentcore.git
cd mcp-bridge-demo
chmod +x scripts/setup.sh manifests/install.sh
./scripts/setup.sh

이 셸 명령은 저장소를 복제하고 로컬 설정 스크립트를 실행해 예제 브리지와 MCP 서버 샘플을 준비한다. 저장소에는 확장, 브리지, 샘플 MCP 서버 및 배포 지침이 포함되어 있어 로컬에서 재현 가능한 데모 환경을 빠르게 구축할 수 있다. 실제 배포 전 스크립트가 요구하는 Python 및 Node 버전, AWS 자격 증명을 먼저 확인해야 한다.