MCP Server Do

🚀 SSE + MCP サーバー + Durable Objects

このプロジェクトは、@modelcontextprotocol/typescript-sdk と連携する以下のコンポーネントを提供します。

1. /src/sse.ts にある @modelcontextprotocol/typescript-sdk と連携する SSE 伝送層
2. /src/mcp-server-do.ts にある Durable Object としての MCP サーバー
3. エンドツーエンドでの実行手順

🚀 クイックスタート

実行手順

1. このリポジトリをクローンします。
2. npm install を実行して依存関係をインストールします。
3. npm start を実行して DO を起動します（アクセスアドレスは http://localhost:8787）。
4. npx @modelcontextprotocol/inspector を使用して MCP Inspector を実行します。
5. Inspector を開き、http://localhost:8787/sse を入力します。

これで以下のような表示が見えるはずです。

📚 ドキュメント

詳細情報

私は このサンプル からインスピレーションを得ました。このサンプルは @modelcontextprotocol/typescript-sdk からのものです。

import express from "express";
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { SSEServerTransport } from "@modelcontextprotocol/sdk/server/sse.js";

const server = new McpServer({
  name: "example-server",
  version: "1.0.0"
});

// ... サーバーのリソース、ツール、ヒントを設定 ...

const app = express();

app.get("/sse", async (req, res) => {
  const transport = new SSEServerTransport("/messages", res);
  await server.connect(transport);
});

app.post("/messages", async (req, res) => {
  // 注意：複数の同時接続をサポートするには、これらのメッセージを特定のトランスポートにルーティングする必要があります。簡単にするため、ここではこのロジックを実装していません。
  await transport.handlePostMessage(req, res);
});

app.listen(3001);

このコードを参考に、Durable Objects として実装しました。ただし、まず Workers 上で動作するトランスポート層が必要です。sse.ts は @modelcontextprotocol/typescript-sdk から 取得し、既存のコードの構造と機能をできるだけ模倣したバージョンを実装しました。SDK には Node.js の http モジュールと深く結合した設計仮定がいくつかあり、これらが SSE トランスポート層とその入力タイプに漏れ出しています。ただし、唯一意味のあるインターフェースの変更は、handlePostMessage がリクエストを受け取り、レスポンスを返すことです。これを上流化する巧妙な方法があるように見えます。