MCP 서버 전송

개요

피드백
• STDIO 전송(로컬 서버)
피드백
• Streamable HTTP 전송(원격 서버를 위한 최신 표준)
피드백
• SSE 전송(제거됨)

STDIO 전송

STDIO 전송 작동 방식

피드백
1. Bob이 MCP 서버를 자식 프로세스로 시작
피드백
2. 통신은 프로세스 스트림을 통해 발생: Bob은 서버의 STDIN에 쓰고 서버는 STDOUT에 응답
피드백
3. 각 메시지는 개행 문자로 구분
피드백
4. 메시지는 JSON-RPC 2.0으로 형식화

Client                    Server
  |                         |
  |---- JSON 메시지 ---->| (STDIN을 통해)
  |                         | (요청 처리)
  |<---- JSON 메시지 ----| (STDOUT을 통해)
  |                         |

STDIO 특성

피드백
• 로컬성: Bob과 동일한 머신에서 실행
피드백
• 성능: 매우 낮은 지연 시간 및 오버헤드(네트워크 스택 관련 없음)
피드백
• 단순성: 네트워크 구성 없이 직접 프로세스 통신
피드백
• 관계: 클라이언트와 서버 간 일대일 관계
피드백
• 보안: 네트워크 노출 없이 본질적으로 더 안전

STDIO를 사용하는 경우

피드백
• 동일한 머신에서 실행되는 로컬 통합 및 도구
피드백
• 보안이 중요한 작업
피드백
• 낮은 지연 시간 요구 사항
피드백
• 단일 클라이언트 시나리오(서버당 하나의 Bob 인스턴스)
피드백
• 명령줄 도구 또는 IDE 확장

STDIO 구현 예제

const server = new Server({name: 'local-server', version: '1.0.0'});
// 도구 등록...

// STDIO 전송 사용
const transport = new StdioServerTransport(server);
transport.listen();

Streamable HTTP 전송

Streamable HTTP 전송 작동 방식

피드백
1. 서버는 POST 및 GET 메서드를 모두 지원하는 단일 HTTP 엔드포인트(MCP 엔드포인트) 제공
피드백
2. Bob은 HTTP POST로 이 MCP 엔드포인트에 요청 전송
피드백
3. 서버가 요청을 처리하고 응답 반환
피드백
4. 선택적으로 서버는 동일한 연결을 통해 Server-Sent Events(SSE)를 사용하여 Bob에게 여러 메시지 또는 알림을 스트리밍할 수 있음

Client                             Server
  |                                  |
  |---- HTTP POST /mcp_endpoint ---->| (클라이언트 요청)
  |                                  | (요청 처리)
  |<--- HTTP Response / SSE Stream --| (서버 응답 / 스트림)
  |                                  |

Streamable HTTP 특성

피드백
• 최신 표준: 새로운 원격 MCP 서버 구현을 위한 선호 방법
피드백
• 원격 액세스: Bob과 다른 머신에서 호스팅 가능
피드백
• 확장성: 여러 클라이언트 연결을 동시에 처리 가능
피드백
• 프로토콜: 표준 HTTP/HTTPS를 통해 작동
피드백
• 유연성: 간단한 요청-응답 및 고급 스트리밍 지원
피드백
• 단일 엔드포인트: 모든 MCP 통신에 단일 URL 경로 사용
피드백
• 인증: 표준 HTTP 인증 메커니즘 사용 가능
피드백
• 하위 호환성: 서버는 이전 HTTP+SSE 클라이언트와의 호환성 유지 가능

Streamable HTTP를 사용하는 경우

피드백
• 모든 새로운 원격 MCP 서버 개발
피드백
• 강력하고 확장 가능하며 유연한 통신이 필요한 서버
피드백
• 스트리밍 데이터 또는 서버 전송 알림을 포함할 수 있는 통합
피드백
• 공개 서비스 또는 중앙 집중식 도구
피드백
• 레거시 SSE 전송 구현 교체

프로토콜 협상

{
  "mcpServers": {
    "my-server": {
      "url": "https://your-server-url.com/mcp",
      "protocolNegotiation": "legacy"
    }
  }
}

Streamable HTTP 구현 예제

{
  "mcpServers": {
    "StreamableHTTPMCPName": {
      "type": "streamable-http",
      "url": "http://localhost:8080/mcp"
    }
  }
}

HTTP+SSE와의 하위 호환성

SSE 전송(제거됨)

SSE 전송에서 마이그레이션

피드백
• Streamable HTTP: HTTP POST 요청을 수락하는 단일 MCP 엔드포인트를 노출합니다. 원격 서버에 권장되는 경로입니다. Streamable HTTP 전송을 참조하세요.
피드백
• STDIO: 서버가 Bob과 동일한 머신에서 로컬로 실행되는 경우 STDIO 서버로 변환하세요. STDIO 전송을 참조하세요.

배포 고려 사항

STDIO: 로컬 배포

피드백
• 설치: 서버 실행 파일을 각 사용자의 컴퓨터에 설치해야 함
피드백
• 배포: 다양한 운영 체제에 대한 설치 패키지 제공 필요
피드백
• 업데이트: 각 인스턴스를 개별적으로 업데이트해야 함
피드백
• 리소스: 로컬 머신의 CPU, 메모리 및 디스크 사용
피드백
• 액세스 제어: 로컬 머신의 파일 시스템 권한에 의존
피드백
• 통합: 로컬 시스템 리소스(파일, 프로세스)와 쉽게 통합
피드백
• 실행: Bob과 함께 시작 및 중지(자식 프로세스 수명 주기)
피드백
• 종속성: 모든 종속성을 사용자의 컴퓨터에 설치해야 함

피드백
• 사용자의 컴퓨터에서 실행
피드백
• 로컬 파일 시스템에 직접 액세스
피드백
• 필요에 따라 Bob에 의해 시작
피드백
• 네트워크 구성 불필요
피드백
• Bob과 함께 또는 패키지 관리자를 통해 설치 필요

원격: 호스팅 배포

피드백
• 설치: 서버에 한 번 설치되고 많은 사용자가 호출
피드백
• 배포: 단일 배포가 여러 클라이언트 제공
피드백
• 업데이트: 중앙 집중식 업데이트가 모든 사용자에게 즉시 영향
피드백
• 리소스: 로컬 머신 리소스가 아닌 서버 리소스 사용
피드백
• 액세스 제어: 인증 및 권한 부여 시스템을 통해 관리
피드백
• 통합: 사용자별 리소스와의 더 복잡한 통합
피드백
• 실행: 독립 서비스로 실행(종종 지속적으로)
피드백
• 종속성: 사용자 머신이 아닌 서버에서 관리

피드백
• 중앙 서버에서 실행
피드백
• 서버 측 자격 증명으로 데이터베이스에 연결
피드백
• 여러 사용자에게 지속적으로 사용 가능
피드백
• 적절한 네트워크 보안 구성 필요
피드백
• 컨테이너 또는 클라우드 기술로 배포

하이브리드 접근 방식

피드백
1. 네트워크 액세스가 있는 STDIO: 원격 서비스의 프록시 역할을 하는 로컬 STDIO 서버
피드백
2. 로컬 명령이 있는 원격: 콜백을 통해 클라이언트 머신에서 작업을 트리거할 수 있는 원격 서버
피드백
3. 게이트웨이 패턴: 전문화된 기능을 위해 원격 서버에 연결하는 로컬 작업용 STDIO 서버

전송 비교

Bob에서 전송 구성