リモートMCPサーバー

リモートMCP: リモートモデルコンテキストプロトコル

リモート MCP 通信用の型安全で双方向のシンプルなソリューション。モデルコンテキストのリモートアクセスと集中管理を可能にします。

プレビュー

建築

私がこれを作った理由（今）

はい、公式のMCPロードマップには2025年第1四半期にリモートMCPサポートが含まれていることは承知しています。しかし、リモートアクセスの必要性は私にとって、そしておそらく多くの人にとって差し迫ったものでした。このライブラリは、そのギャップを埋めるために作成されました。将来の公式実装を待つことなく、ローカルMCPクライアントからリモートMCPサーバーに今すぐ接続する方法を提供します。

注：これを複雑すぎるものにしたくはありません。今のところはこの方法でうまくいっています。

はじめる

注: このプロジェクトは現在開発中であり、実験段階です。変更や潜在的な問題が発生する可能性があります。

クライアントの使用状況

公開パッケージを使用する

MCP クライアント設定に次のコードを入力するだけです。ここでは、例として Claude を使用しています。

{
  "mcpServers": {
    "remote-mcp": {
      "command": "npx",
      "args": ["-y", "@remote-mcp/client"],
      "env": {
        "REMOTE_MCP_URL": "http://localhost:9512",
        "HTTP_HEADER_Authorization": "Bearer <token>"
      }
    }
  }
}

独自のローカル MCP サーバーをコーディングする

インストール要件:

$ npm install @remote-mcp/client @trpc/client@next zod

次に、次のような独自のコードを記述します。

import { RemoteMCPClient } from "@remote-mcp/client";

const client = new RemoteMCPClient({
  remoteUrl: "http://localhost:9512",

  onError: (method, error) => console.error(`Error in ${method}:`, error)
});

void client.start();

サーバーの使用（リモート MCP 実装）

いくつかの例はexamplesディレクトリで参照できます。

独自のリモート MCP サーバーをコーディングする

npm install @remote-mcp/server実行すると、次のようにして独自のリモート MCP サーバーを作成できます。

import { MCPRouter, LogLevel } from "@remote-mcp/server";
import { createHTTPServer } from '@trpc/server/adapters/standalone';

import { z } from "zod";

// Create router instance
const mcpRouter = new MCPRouter({
  logLevel: LogLevel.DEBUG,
  name: "example-server",
  version: "1.0.0",
  capabilities: {
    logging: {},
  },
});

// Add example tool
mcpRouter.addTool(
  "calculator",
  {
    description:
      "Perform basic calculations. Add, subtract, multiply, divide. Invoke this every time you need to perform a calculation.",
    schema: z.object({
      operation: z.enum(["add", "subtract", "multiply", "divide"]),
      a: z.string(),
      b: z.string(),
    }),
  },
  async (args) => {
    const a = Number(args.a);
    const b = Number(args.b);

    let result: number;
    switch (args.operation) {
      case "add":
        result = Number(a) + b;
        break;
      case "subtract":
        result = a - b;
        break;
      case "multiply":
        result = a * b;
        break;
      case "divide":
        if (b === 0) throw new Error("Division by zero");
        result = a / b;
        break;
    }

    return {
      content: [{ type: "text", text: `${result}` }],
    };
  },
);

const appRouter = mcpRouter.createTRPCRouter();

void createHTTPServer({
  router: appRouter,
  createContext: () => ({}),
}).listen(Number(process.env.PORT || 9512));

すると、MCP クライアントで次のように表示されます。

パッケージ

このリポジトリには次のものが含まれます。

@remote-mcp/client : ローカル MCP サーバーとして機能し、リモート実装に接続するクライアントライブラリ。
@remote-mcp/server : リモートからアクセス可能な MCP サービスを作成するためのサーバーライブラリ (リモート実装として使用)。

ロードマップ

コア機能

[x] 基本的な型安全なクライアント/サーバー通信
- [x] 基本的なMCPコマンドのサポート
- [x] 基本的なMCPツールのサポート
- [x] 基本的なMCPプロンプトのサポート
- [ ] クラッシュセーフハンドリング（WIP、最優先事項）
[ ] 完全なイベントサブスクリプションシステム
- [ ] リソース変更通知
- [ ] ツール/プロンプトリストの変更通知
[ ] HTTPヘッダーのサポート
- [x] カスタムヘッダー
- [ ] 認証ミドルウェア
[ ] 基本的なエラー処理の改善
[ ] 基本的なミドルウェアのサポート

フレームワークのサポート

[ ] Nest.js 統合 ( @remote-mcp/nestjs )

高度な機能

[ ] 双方向通信
- [ ] サーバーからクライアントへのリクエスト
- [ ] サーバー/クライアント間のリソース共有
[ ] 基本的な監視とログ記録

貢献する

貢献を歓迎します。詳細はCONTRIBUTING.mdをご覧ください。

免責事項

このライブラリは、既存の MCP コンセプトに基づいて構築された補完的な拡張機能であり、公式の MCP 仕様の一部ではありません。

ライセンス

このプロジェクトはMITライセンスの下で提供されています。詳細はLICENSEファイルをご覧ください。

参考文献

モデルコンテキストプロトコル

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

モデルコンテキストプロトコルサービスとの型セーフな双方向通信を可能にし、HTTP 経由のモデルコンテキストの集中管理を可能にします。

Related Resources

Reddit Discussion about this server

Related MCP Servers

MCP Server Fetch TypeScript
tatn
A
security
A
license
A
quality
A Model Context Protocol server that provides web content fetching and conversion capabilities.
Last updated -
4
89
2
JavaScript
MIT License
WASM MCP Server
beekmarks
-
security
F
license
-
quality
This server enables running a Model Context Protocol in a web browser with functionalities including arithmetic operations and session-based key-value storage.
Last updated -
2
TypeScript
Notion MCP Server
ccabanillas
-
security
A
license
-
quality
A Model Context Protocol server that provides a standardized interface for interacting with Notion's API, enabling users to list databases, create pages, and search across their Notion workspace.
Last updated -
95
Python
MIT License
Confluence MCP Server
minhoyooDEV
-
security
F
license
-
quality
A Model Context Protocol server for accessing Confluence API using Personal Access Tokens, enabling users to retrieve space lists, view pages, create new pages, and update existing content.
Last updated -
TypeScript

View all related MCP servers

Remote-MCP Server