punkpeye/mcp-remote

해결하는 문제

많은 Model Context Protocol (MCP) 클라이언트(예: Claude Desktop, Cursor, Windsurf)는 현재 로컬(stdio) 연결로 제한되어 있습니다. 이로 인해 사용자가 원격의 웹 호스팅 MCP 서버에 쉽게 연결할 수 없습니다. mcp-remote는 브리지 역할을 하여 이러한 로컬 클라이언트가 HTTP/SSE를 통해 원격 서버에 연결할 수 있도록 하면서 필요한 인증 및 프로토콜 변환을 처리합니다.

작동 방식

mcp-remote는 MCP 클라이언트 설정 내에서 구성하는 프록시입니다. 연결을 가로채고 OAuth 흐름(토큰 저장 및 갱신 포함)을 관리하며 프로토콜 변환을 처리합니다. 인증, 사용자 지정 헤더, 프로토콜 버전 브리징(레거시 클라이언트가 최신 상태 비저장 서버와 통신할 수 있도록 허용)과 같은 최신 MCP 기능을 지원합니다.

대상 사용자

이 도구는 원격의 호스팅된 MCP 서버를 아직 원격 또는 인증된 MCP 연결을 기본적으로 지원하지 않는 데스크톱 AI 애플리케이션과 함께 사용하려는 개발자 및 고급 사용자를 위한 것입니다.

주요 기능

• 원활한 통합: 표준 MCP 구성 파일에서 드롭인 대체품으로 작동합니다.
• 인증 지원: 복잡한 OAuth 흐름, 사용자 지정 헤더, 파일을 통한 안전한 자격 증명 관리를 처리합니다.
• 프로토콜 브리징: 자동 협상 모드를 사용하여 레거시 MCP 클라이언트와 최신 상태 비저장 서버 간의 통신을 가능하게 합니다.
• 고도로 구성 가능: 네트워크 시간 초과, 전송 전략(SSE/HTTP), 프록시 지원, 도구 필터링을 위한 광범위한 CLI 플래그를 제공합니다.