punkpeye/mcp-remote

해결하는 문제

Claude Desktop, Cursor, Windsurf와 같은 인기 있는 모델 컨텍스트 프로토콜(MCP) 클라이언트는 stdio 전송을 통한 로컬 서버만 지원합니다. 이로 인해 HTTP/SSE 및 보안 OAuth 인증 흐름을 필요로 하는 원격 MCP 서버에 연결할 수 없습니다. mcp-remote는 이 stdio 전용 클라이언트가 원격 인증된 MCP 서버에 연결할 수 있도록 다리 역할을 합니다.

작동 방식

이 도구는 npx를 통해 호출되는 로컬 프록시로 작동합니다. 클라이언트는 stdio를 통해 mcp-remote와 통신하고, mcp-remote는 이 요청을 원격 서버로의 HTTP/SSE 호출로 변환합니다. OAuth 인증 프로세스를 처리하며, 토큰 관리, 리프레시 흐름, 사용자 정의 헤더 등을 지원합니다. 또한, 요청을 재작성하고 구독을 관리함으로써 구형 MCP 클라이언트와 현대적(2026-07-28) 서버를 연결하는 '이중 시대 클라이언트'로도 작동할 수 있습니다.

대상 사용자

자신의 머신에 서버 코드를 로컬로 실행하지 않고도 원격 MCP 서버를 사용하고 싶은 Claude Desktop, Cursor, Windsurf 등의 MCP 클라이언트 사용자.

주요 기능

• 인증 지원: OAuth 흐름의 완전한 지원, 사용자 정의 인증 매개변수, 리소스 지시자(RFC 8707), 클라이언트 자격 증명 포함.
• 프로토콜 브리지: 구형(2025-11-25)과 현대적(2026-07-28) MCP 프로토콜 버전 간 자동 변환 가능.
• 유연한 구성: CLI 또는 파일을 통한 사용자 정의 헤더, 프록시 설정, 와일드카드 패턴을 사용한 특정 도구 무시 지원.
• 트랜스포트 제어: http-first, sse-first, http-only, sse-only 중 하나의 전송 전략 선택 가능.
• 연결 안정성: 유지보수용 핑과 설정 가능한 네트워크 타임아웃으로 비활성 연결이 끊어지는 것을 방지.