MCP Server (createMcpHandler)

Самый простой способ запустить MCP-сервер без сохранения состояния на Cloudflare Workers. Использует createMcpHandler из Agents SDK для обработки всех деталей протокола MCP в одной строке.

Что демонстрируется

• createMcpHandler — вспомогательная функция Agents SDK, которая превращает фабрику McpServer в обработчик fetch, совместимый с Workers

• Минимальная настройка — определите инструменты в фабрике, передайте фабрику в createMcpHandler, готово

• Без состояния — никаких Durable Objects, никакого постоянного состояния, каждый запрос независим

Related MCP server: remote-mcp-server-authless

Запуск

pnpm install
pnpm start

Откройте браузер, чтобы увидеть встроенный тестер инструментов, или подключитесь с помощью MCP Inspector по адресу http://localhost:5173/mcp.

Как это работает

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;

Связанные примеры

• mcp — MCP-сервер с сохранением состояния с помощью McpAgent и Durable Objects

• mcp-worker-authenticated — добавление OAuth-аутентификации

• mcp-client — подключение к MCP-серверам в качестве клиента