Rgarcia MCP Server Server

🚀 mcp-server-server

このリポジトリは、他のMCPサーバーを起動できるMCPサーバーの概念実証プロジェクトです。MCPサーバーの使用は不便ですが、このプロジェクトはその問題を解決し、より効率的な利用を可能にします。

🚀 クイックスタート

なぜこのプロジェクトが必要なのか

MCPサーバーの主な伝送メカニズムは標準入出力（stdio）です。つまり、MCPクライアントプログラムでは、使用したい各MCPサーバーに対して新しいプロセスを生成する必要があります。これには以下のような欠点があります。

1. 手間がかかる：各MCPクライアントはプロセスマネージャーになる必要があります。Claude Desktopの設定方法は、実行するプロセスのリストを維持する必要があることを示す良い例です。
2. インフラストラクチャの問題：複数のユーザーがいて、それぞれが異なるMCPサーバー設定（例えば、GithubやGoogle Driveなどの異なる基盤MCPサーバーへのアクセス認証資格情報）を持っている場合、大量のプロセスを管理し、クライアントのリクエストをルーティングする必要があります。

より良い方法

MCPサーバーを実際に...サーバーにする、つまり、stdioではなくネットワークを介して通信するようにすると、プログラムで簡単に使用できます。

第1ステップ：既存のstdio MCPサーバーをWebSocket MCPサーバーに変換

このリポジトリには、既存のMCPサーバー（ここに公式のリストがありますが、現在は分散しています）をWebSocket経由で公開するラッパープログラムが含まれています。

bun run mcp-server -p 3001 -- npx -y @modelcontextprotocol/server-puppeteer@latest

第2ステップ：プロセスを管理することなくプログラムでMCPサーバーとやり取りする

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { WebSocketClientTransport } from "@modelcontextprotocol/sdk/client/websocket.js";

const transport = new WebSocketClientTransport(new URL("ws://localhost:3001"));

const client = new Client(
  {
    name: "example-client",
    version: "1.0.0",
  },
  {
    capabilities: {},
  }
);
await client.connect(transport);
const tools = await client.listTools();
console.log(
  "ツール:",
  tools.tools.map((t) => t.name)
);
await client.close();

bun run mcp-server-wrapper-client
$ bun run src/mcp-server-wrapper/example-client/example-client.ts
ツール: [ "puppeteer_navigate", "puppeteer_screenshot", "puppeteer_click", "puppeteer_fill",
  "puppeteer_evaluate"
]

第3ステップ：MCPサーバーを構築する

TODO: 現在、MCPクライアント開発者は、第1ステップで特定のMCPサーバーとユーザー設定に対してプログラムを生成する必要があります。単一のMCPサーバーがツールを公開して起動できるようにする問題はまだ解決されていません。

✨ 主な機能

プロジェクトの目標

このリポジトリは、従来のstdioベースのMCPサーバーをWebSocketを介して通信するネットワークサーバーに変換する方法を示し、クライアントとのやり取りを簡素化します。

主な利点

1. プロセス管理の削除：クライアントで複数のプロセスを生成して異なるMCPサーバーを管理する必要がなくなります。
2. 拡張性の向上：ネットワーク通信により、複数のユーザーと異なる設定をより効率的に管理し、リクエストをルーティングできます。

実装手順

1. 既存のMCPサーバーをWebSocketサービスとしてラップする

提供されているラッパープログラムを使用すると、任意の既存のMCPサーバー（例えばPuppeteer）をWebSocketベースのサービスに簡単に変換できます。例えば：

bun run mcp-server -p 3001 -- npx -y @modelcontextprotocol/server-puppeteer@latest

このコマンドは、ポート3001でWebSocketサービスを起動し、Puppeteer MCPサーバーをラップします。

2. SDKを使用してプログラムでやり取りする

MCP SDKとWebSocketクライアントトランスポートモジュールを使用すると、新しいWebSocket MCPサーバーと簡単にやり取りできます。例えば：

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { WebSocketClientTransport } from "@modelcontextprotocol/sdk/client/websocket.js";

const transport = new WebSocketClientTransport(new URL("ws://localhost:3001"));

const client = new Client(
  {
    name: "example-client",
    version: "1.0.0",
  },
  {
    capabilities: {},
  }
);
await client.connect(transport);
const tools = await client.listTools();
console.log(
  "ツール:",
  tools.tools.map((t) => t.name)
);
await client.close();

このコードを実行すると：

bun run mcp-server-wrapper-client
$ bun run src/mcp-server-wrapper/example-client/example-client.ts
ツール: [ "puppeteer_navigate", "puppeteer_screenshot", "puppeteer_click", "puppeteer_fill",
  "puppeteer_evaluate"
]

出力には利用可能なツールのリストが表示されます。

3. MCPサーバー即サービスへの拡張

TODO: 現在、MCPクライアント開発者は、第1ステップで特定のMCPサーバーとユーザー設定に対してプログラムを生成する必要があります。単一のMCPサーバーがツールを公開して起動できるようにする問題はまだ解決されていません。

将来の方向性

1. 統一インターフェース：汎用的なMCPサーバーインターフェースを開発し、任意のサーバーがWebSocketまたは他のプロトコルを介して簡単に公開できるようにします。
2. 自動化設定：ユーザー設定の自動管理を実現し、手動でのプロセス生成の必要性を減らします。
3. マルチテナントサポート：複数のユーザーをサポートするアーキテクチャを構築し、各ユーザーが必要に応じて異なるMCPサーバーインスタンスをカスタマイズして起動できるようにします。

結論

MCPサーバーをネットワークサービスに変換することは画期的な改善であり、開発効率とシステムの拡張性を大幅に向上させます。現在はまだいくつかの問題が残っていますが、この方向は確かに深く探求し実践する価値があります。