远程 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 分钟部署教程
- 生成并下载 — 选择预设或手工填写表单 → 点击右上角
Download Starter (.zip)获取完整工程包。 - 解压安装依赖 —
unzip——工程零运行时依赖,仅需 devDependencies 中的 wrangler 与 TypeScript。-remote-mcp.zip && cd && npm install - 配置凭据 — Bearer 模式执行
npx wrangler secret put MCP_API_KEY;OAuth 模式在 wrangler.jsonc 中填入你的 AUTH_SERVER_ISSUER(WorkOS / Clerk / Auth0…)。 - 部署上线 —
npx wrangler deploy——30 秒内你的 MCP 端点就在 Cloudflare 边缘全球可用,域名形如https://。. .workers.dev/mcp - 验证与收录 — 把端点粘贴进本站 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 调用即可,协议层无需改动。