Безопасное по типу, двустороннее и простое** решение для удалённой MCP-связи, позволяющее удалённый доступ и централизованное управление контекстами моделей.

Архитектура

Почему я это сделал (сейчас)

Да, я знаю, что официальная дорожная карта MCP предусматривает поддержку удалённого MCP в первом квартале 2025 года. Однако необходимость в удалённом доступе была немедленной для меня и, вероятно, для многих других. Эта библиотека была создана, чтобы преодолеть этот разрыв, предоставляя возможность подключения к удалённому 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": {