MCP Worker Server
MCP 서버 (createMcpHandler)
Cloudflare Workers에서 상태 비저장 MCP 서버를 실행하는 가장 간단한 방법입니다. Agents SDK의 createMcpHandler를 사용하여 모든 MCP 프로토콜 세부 사항을 한 줄로 처리합니다.
시연 내용
createMcpHandler— Agents SDK 헬퍼로,McpServer팩토리를 Worker 호환 fetch 핸들러로 변환합니다.최소 설정 — 팩토리에서 도구를 정의하고, 팩토리를
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—McpAgent및 Durable Objects를 사용한 상태 저장 MCP 서버mcp-worker-authenticated— OAuth 인증 추가mcp-client— 클라이언트로서 MCP 서버에 연결
This server cannot be deployed
Maintenance
Related MCP Connectors
Cloudflare Workers MCP server: ai-model-router
Zero-dependency Cloudflare Worker gateway turning websites and REST APIs into MCP tools.
Cloudflare Workers MCP server: code-explainer
Cloudflare Workers MCP server: ai-agent-scratchpad
Related MCP Servers
- FlicenseNot gradedqualityBmaintenanceEnables running a stateless MCP server on Cloudflare Workers with minimal setup, leveraging createMcpHandler for handling MCP protocol.-
- FlicenseNot gradedqualityBmaintenanceEnables deploying a stateless remote MCP server on Cloudflare Workers without authentication, with support for custom tool registration and connections from MCP clients.-
- FlicenseNot gradedqualityCmaintenanceEnables running a stateless MCP server on Cloudflare Workers with minimal setup, using a single fetch handler to expose tools through the MCP protocol.1-
- FlicenseNot gradedqualityBmaintenanceEnables deploying a stateless remote MCP server on Cloudflare Workers without authentication, allowing custom tool registration and connection from remote MCP clients.-