远程 MCP 服务器生成器 — Cloudflare Workers 脚手架 60 秒上线

可视化配置基础信息、三种鉴权模式与 1~8 个工具,右侧实时生成完整 Workers 工程(src/index.ts、wrangler.jsonc、package.json、README),一键打包 zip 下载并部署到边缘。

Configure your MCP server
Acme Analytics · lowercase kebab-case
Generated starter
// Acme Analytics MCP — Remote MCP server on Cloudflare Workers.
// Generated by https://remotemcp.net/generator — test it at
//   https://remotemcp.net/inspector?url=https%3A%2F%2Fmcp.acme.com%2Fmcp

interface Env {
}

const CORS: Record<string, string> = {
    "Access-Control-Allow-Origin": "*",
    "Access-Control-Allow-Methods": "GET, POST, OPTIONS",
    "Access-Control-Allow-Headers": "Content-Type, Authorization, Mcp-Session-Id, MCP-Protocol-Version",
    "Access-Control-Expose-Headers": "Mcp-Session-Id, WWW-Authenticate",
};

const TOOLS = [
    {
        name: "run_query",
        description: "Run a named analytics query and return rows as JSON.",
        inputSchema: {
                "type": "object",
                "properties": {
                        "query": {
                                "type": "string",
                                "description": "Query key or SQL"
                        },
                        "limit": {
                                "type": "number",
                                "description": "Row limit"
                        }
                },
                "required": [
                        "query"
                ]
        }, annotations: { readOnlyHint: true },
    }
];

const rpc = (id: unknown, result: unknown) => ({ jsonrpc: "2.0", id: id ?? null, result });
const rpcErr = (id: unknown, code: number, message: string) => ({ jsonrpc: "2.0", id: id ?? null, error: { code, message } });

function handleRpc(method: string, params: Record<string, unknown>, id: unknown): unknown | null {
    switch (method) {
        case "initialize":
            return rpc(id, {
                protocolVersion: "2025-03-26",
                capabilities: { tools: {} },
                serverInfo: { name: "acme-analytics", version: "1.0.0" },
            });
        case "ping":
            return rpc(id, {});
        case "tools/list":
            return rpc(id, { tools: TOOLS });
        case "tools/call": {
            const name = typeof params.name === "string" ? params.name : "";
            const args = (params.arguments ?? {}) as Record<string, unknown>;
            switch (name) {
        case "run_query":
            // TODO: call your real backend here.
            return { content: [{ type: "text", text: JSON.stringify({ tool: name, args, note: "stub — wire this tool to your API" }, null, 2) }] };
                default:
                    return { content: [{ type: "text", text: `Unknown tool '${name}'` }], isError: true };
            }
        }
        default:
            if (method.startsWith("notifications/")) return null; // 202
            return rpcErr(id, -32601, `Method not found: ${method}`);
    }
}

export default {
    async fetch(request: Request, env: Env): Promise<Response> {
        const url = new URL(request.url);

        if (request.method === "OPTIONS") return new Response(null, { status: 204, headers: CORS });

    if (url.pathname === "/.well-known/oauth-protected-resource") {
        // RFC 9728 Protected Resource Metadata — points clients at your AS.
        const body = {
            resource: `${url.origin}/mcp`,
            authorization_servers: [env.AUTH_SERVER_ISSUER ?? "https://your-auth-server.example.com"],
            scopes_supported: ["mcp:read", "mcp:write"],
            bearer_methods_supported: ["header"],
        };
        return new Response(JSON.stringify(body, null, 2), { headers: { "Content-Type": "application/json", ...CORS } });
    }
        if (url.pathname === "/.well-known/mcp.json") {
            const card = {
                name: "com.acmeanalytics/server",
                title: "Acme Analytics MCP",
                description: "Analytics query & reporting tools exposed as a remote MCP server.",
                version: "1.0.0",
                homepageUrl: `${url.origin}`,
                remotes: [{ type: "streamable-http", url: `${url.origin}/mcp` }],
                authentication: { type: "none" },
                capabilities: { tools: true },
            };
            return new Response(JSON.stringify(card, null, 2), { headers: { "Content-Type": "application/json", ...CORS } });
        }

        if (url.pathname === "/mcp" && request.method === "POST") {
            let payload: unknown;
            try {
                payload = await request.json();
            } catch {
                return new Response(JSON.stringify(rpcErr(null, -32700, "Parse error")), { status: 400, headers: { "Content-Type": "application/json", ...CORS } });
            }
            const reqs = Array.isArray(payload) ? payload : [payload];
            const out: unknown[] = [];
            for (const r of reqs as { id?: unknown; method?: string; params?: Record<string, unknown> }[]) {
                if (!r || typeof r.method !== "string") continue;
                if (r.id === undefined && r.method.startsWith("notifications/")) continue;
                const res = handleRpc(r.method, r.params ?? {}, r.id);
                if (res !== null) out.push(res);
            }
            if (out.length === 0) return new Response(null, { status: 202, headers: CORS });
            return new Response(JSON.stringify(Array.isArray(payload) ? out : out[0]), {
                headers: { "Content-Type": "application/json", ...CORS },
            });
        }

        return new Response(`Acme Analytics MCP — MCP endpoint at /mcp\n`, { headers: CORS });
    },
} satisfies ExportedHandler<Env>;

🚀 5 分钟部署教程

  1. 生成并下载 — 选择预设或手工填写表单 → 点击右上角 Download Starter (.zip) 获取完整工程包。
  2. 解压安装依赖 — unzip -remote-mcp.zip && cd && npm install——工程零运行时依赖,仅需 devDependencies 中的 wrangler 与 TypeScript。
  3. 配置凭据 — Bearer 模式执行 npx wrangler secret put MCP_API_KEY;OAuth 模式在 wrangler.jsonc 中填入你的 AUTH_SERVER_ISSUER(WorkOS / Clerk / Auth0…)。
  4. 部署上线 — npx wrangler deploy——30 秒内你的 MCP 端点就在 Cloudflare 边缘全球可用,域名形如 https://..workers.dev/mcp。
  5. 验证与收录 — 把端点粘贴进本站 Inspector 实测 initialize 与 tools/list,再到 Submit MCP 提交收录。

❓ 常见问题

生成的 MCP 服务器需要哪些依赖?

零运行时依赖:生成的 src/index.ts 是纯 TypeScript Cloudflare Worker,完整实现 JSON-RPC 握手、tools/list、tools/call、resources、CORS 与 Server Card——不需要任何 MCP SDK。

支持哪些鉴权方式?

三种:免密公开、Bearer API Key(Wrangler secret 存凭据)与 OAuth 2.1 RFC 9728(自动生成受保护资源元数据端点 + 401 挑战 + CORS 暴露头,可直接对接 WorkOS/Clerk/Auth0)。

ui:// MCP App 组件是什么?

MCP Apps 规范允许服务端通过 resources/read 返回 text/html;profile=mcp-app 的交互式 HTML 组件,在支持的客户端中以沙盒渲染。开启开关即可生成一个可点击的示例 widget。

生成的项目如何自定义工具逻辑?

src/index.ts 中每个工具都有 // TODO: call your real backend here 标记的 case——替换为对真实后端 API 的 fetch 调用即可,协议层无需改动。

🔬 在 Inspector 中测试生成的端点 →