개요
Streamable HTTP 전송은 원격 MCP 서버에 연결할 수 있는 유연한 방법을 제공합니다. 이는 종종 HTTP를 기반으로 구축되며, 요청-응답 및 스트리밍을 포함한 다양한 통신 패턴을 지원할 수 있습니다. 때때로 더 넓은 HTTP 상호작용 내에서 서버-클라이언트 스트림을 위해 Server-Sent Events(SSE)를 활용하기도 합니다.주요 개념
- 원격 서버: 원격에 호스팅된 MCP 서버용으로 설계되었습니다.
- 유연성: 단순 SSE보다 더 복잡한 상호작용 패턴을 지원할 수 있으며, 서버가 구현한 경우 양방향 통신도 가능할 수 있습니다.
MCPServerAdapter
구성: MCP 통신을 위한 서버의 기본 URL을 제공하고, 전송 유형으로"streamable-http"
를 지정해야 합니다.
스트리머블 HTTP를 통한 연결
Streamable HTTP MCP 서버와의 연결 라이프사이클을 관리하는 주요 방법에는 두 가지가 있습니다:1. 완전히 관리되는 연결(추천)
추천되는 방법은 Python 컨텍스트 매니저(with
문)을 사용하는 것으로, 연결의 설정과 해제를 자동으로 처리합니다.
"http://localhost:8001/mcp"
은 실제 사용 중인 Streamable HTTP MCP 서버의 URL로 교체해야 합니다.
2. 수동 연결 라이프사이클
보다 명시적인 제어가 필요한 시나리오에서는MCPServerAdapter
연결을 직접 관리할 수 있습니다.
연결을 종료하고 리소스를 해제하려면 작업이 끝난 후 반드시
mcp_server_adapter.stop()
을 호출하는 것이 매우 중요합니다. 이를 보장하는 가장 안전한 방법은 try...finally
블록을 사용하는 것입니다.보안 고려사항
Streamable HTTP 전송을 사용할 때는 일반적인 웹 보안 모범 사례가 매우 중요합니다:- HTTPS 사용: 데이터 전송을 암호화하기 위해 항상 MCP 서버 URL에 HTTPS(HTTP Secure)를 사용하는 것이 좋습니다.
- 인증: MCP 서버가 민감한 도구나 데이터를 노출하는 경우 강력한 인증 메커니즘을 구현하세요.
- 입력 검증: MCP 서버가 모든 수신 요청과 매개변수를 반드시 검증하도록 하십시오.