Servidor MCP (createMcpHandler)

La forma más sencilla de ejecutar un servidor MCP sin estado en Cloudflare Workers. Usa createMcpHandler del SDK de Agents para manejar todos los detalles del protocolo MCP en una sola línea.

Lo que demuestra

• createMcpHandler — el helper del SDK de Agents que convierte una fábrica de McpServer en un manejador fetch compatible con Workers

• Configuración mínima — define herramientas en una fábrica, pasa la fábrica a createMcpHandler, listo

• Sin estado — sin Durable Objects, sin estado persistente, cada solicitud es independiente

Related MCP server: createMcpHandler MCP Server

Ejecución

pnpm install
pnpm start

Abre el navegador para ver el probador de herramientas integrado, o conéctate con el MCP Inspector en http://localhost:5173/mcp.

Cómo funciona

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;

Ejemplos relacionados

• mcp — servidor MCP con estado usando McpAgent y Durable Objects

• mcp-worker-authenticated — añadiendo autenticación OAuth

• mcp-client — conectándose a servidores MCP como cliente