타입 안전, 양방향, 단순 솔루션으로, 원격 MCP 통신을 위한 원격 접근과 모델 컨텍스트의 중앙 집중식 관리를 가능하게 합니다.

건축

왜 내가 이걸 만들었는지 (지금)

네, 공식 MCP 로드맵에 2025년 1분기에 원격 MCP 지원이 포함되어 있다는 것은 알고 있습니다. 하지만 원격 접속의 필요성은 저뿐만 아니라 많은 사람들에게도 즉각적이었습니다. 이 라이브러리는 그 간극을 메우기 위해 만들어졌으며, 현재 로컬 MCP 클라이언트에서 원격 MCP 서버에 연결할 수 있는 방법을 제공하며, 향후 공식 구현을 기다리지 않고도 마찬가지였습니다.

참고: 이 작업이 복잡하거나 복잡하게 느껴지길 원하지 않습니다. 이 방법이 지금은 그냥 잘 작동합니다.

시작하기

참고: 이 프로젝트는 현재 활발히 개발 중이며 실험 단계로 간주됩니다. 획일적인 변경 사항과 잠재적 문제들이 발생할 수 있습니다.

클라이언트 사용

공개 배포 패키지 사용

MCP 클라이언트 설정에 다음 코드를 넣으세요. 여기서는 Claude를 예로 들고 있습니다:

직접 로컬 MCP 서버를 코딩하세요

설치 요구사항:

그 다음 다음과 같은 코드를 직접 작성하세요:

서버 사용 (원격 MCP 구현)

examples 디렉터리에서 몇 가지 예시를 볼 수 있습니다.

Remote-MCP: Remote Model Context Protocol

A type-safe, bidirectional and simple solution for remote MCP communication, allowing remote access and centralized management of model contexts.

Architecture

%%{init: {"flowchart": {"htmlLabels": false}} }%%
graph TD
    %% Modern, Bright Color Styling with white text
    classDef client fill:#22c55e,stroke:#059669,stroke-width:2px,color:#ffffff
    classDef gateway fill:#06b6d4,stroke:#0891b2,stroke-width:2px,color:#ffffff
    classDef backend fill:#f97316,stroke:#ea580c,stroke-width:2px,color:#ffffff
    classDef resource fill:#8b5cf6,stroke:#7c3aed,stroke-width:2px,color:#ffffff
    classDef server fill:#06b6d4,stroke:#0891b2,stroke-width:2px,color:#ffffff

    linkStyle default stroke:#64748b,stroke-width:1.5px,stroke-dasharray: 5 5

    %% Current MCP Setup (Multiple Local Servers)
    subgraph Current["Current Setup (Local)"]
        direction LR
        subgraph ClientGroup["Client"]
            A[Client]:::client
        end

        subgraph Servers["Local MCP Servers"]
            direction TB
            B1["Local MCP Server (DB)"]:::server -->|"DB Access"| C1[DB]:::resource
            B2["Local MCP Server (API 1)"]:::server -->|"API Access"| C2["Web API 1"]:::resource
            B3["Local MCP Server (API 2)"]:::server -->|"API Access"| C3["Web API 2"]:::resource
        end

        A -->|"MCP Protocol"| B1
        A -->|"MCP Protocol"| B2
        A -->|"MCP Protocol"| B3
    end

    %% Vertical separator
    Current --> Proposed

    %% Proposed MCP Architecture (Decoupled)
    subgraph Proposed["Proposed Architecture (Remote)"]
        direction LR
        D[Client/Host]:::client -->|"MCP Protocol"| E["Local MCP Server (@remote-mcp/client)"]:::server
        E |"tRPC(HTTP)"| F["Remote MCP Server (@remote-mcp/server)"]:::backend

        %% Separated Resources
        F -->|"DB Access"| G1[DB]:::resource
        F -->|"API Access"| G2["Web API 1"]:::resource
        F -->|"API Access"| G3["Web API 2"]:::resource
    end

Why I Made This (Now)

Yes, I know that the official MCP roadmap includes remote MCP support in the first quarter of 2025. However, the need for remote access was immediate for me, and likely for many others. This library was created to bridge that gap, providing a way to connect to a remote MCP server from a local MCP client right now, without waiting for future official implementations.

Note: I don’t want this to be a sophisticated or overcomplicated thing. This way just works right now.

Getting Started

Note: This project is currently under active development and is considered experimental. Expect breaking changes and potential issues.

Client Usage

Use Publicly Published Package

Just put the following code in your MCP client settings, in here I’m using Claude as an example:

{
  "mcpServers": {