MCP Server (createMcpHandler)

Der einfachste Weg, einen zustandslosen MCP-Server auf Cloudflare Workers auszuführen. Verwendet createMcpHandler aus dem Agents SDK, um alle MCP-Protokolldetails in einer Zeile zu handhaben.

Was es demonstriert

• createMcpHandler — der Agents SDK-Helfer, der eine McpServer-Factory in einen Worker-kompatiblen Fetch-Handler verwandelt

• Minimale Einrichtung — definieren Sie Tools in einer Factory, übergeben Sie die Factory an createMcpHandler, fertig

• Zustandslos — keine Durable Objects, kein persistenter Zustand, jede Anfrage ist unabhängig

Related MCP server: remote-mcp-server-authless

Ausführen

pnpm install
pnpm start

Öffnen Sie den Browser, um den integrierten Tool-Tester zu sehen, oder verbinden Sie sich mit dem MCP Inspector unter http://localhost:5173/mcp.

Wie es funktioniert

import { McpServer } from "@modelcontextprotocol/server";
import { createMcpHandler } from "agents/mcp/server";
import { z } from "zod";

function createServer() {
  const server = new McpServer({ name: "Hello MCP Server", version: "1.0.0" });
  server.registerTool(
    "hello",
    {
      description: "Returns a greeting",
      inputSchema: { name: z.string().optional() }
    },
    async ({ name }) => ({
      content: [{ type: "text", text: `Hello, ${name ?? "World"}!` }]
    })
  );
  return server;
}

export default {
  fetch(request, env, ctx) {
    return createMcpHandler(createServer)(request, env, ctx);
  }
} satisfies ExportedHandler;

Verwandte Beispiele

• mcp — zustandsbehafteter MCP-Server mit McpAgent und Durable Objects

• mcp-worker-authenticated — Hinzufügen von OAuth-Authentifizierung

• mcp-client — Verbinden zu MCP-Servern als Client