リモートMCPサーバー生成 — Cloudflare Workers テンプレートを60秒で
基本情報・3 種の認証方式・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。ランタイム依存はゼロ、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秒でhttps://がグローバルエッジで稼働。. .workers.dev/mcp - 検証と登録 — エンドポイントを Inspector で initialize / tools/list テストし、Submit MCP から掲載申請。
❓ よくある質問
生成されるサーバーに依存はありますか?
ランタイム依存はゼロです。src/index.ts は純粋な TypeScript Cloudflare Worker で、JSON-RPC ハンドシェイク・tools/list・tools/call・resources・CORS・Server Card をすべて自己完結で実装しています。
どの認証方式に対応していますか?
3 種類です。認証不要(公開)、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 を返せます。トグルをオンにすると動作するサンプルウィジェットが生成されます。
ツールの処理はどこでカスタマイズしますか?
src/index.ts の各ツールの // TODO: call your real backend here case を、実際のバックエンド API への fetch 呼び出しに置き換えるだけです。プロトコル層は変更不要です。