[{"_1":2,"_181":-5,"_182":-5},"loaderData",{"_3":4,"_96":97},"root",{"_5":6,"_37":38,"_69":70},"ctx",{"_7":8,"_23":-5,"_24":25,"_26":27,"_28":20,"_29":20,"_30":20,"_31":-5,"_32":33,"_34":20,"_35":20,"_36":20},"auth",{"_9":-5,"_10":-5,"_11":-5,"_12":-5,"_13":-5,"_14":-5,"_15":-5,"_16":-5,"_17":-5,"_18":-5,"_19":20,"_21":22},"sessionClaims","sessionId","sessionStatus","userId","actor","orgId","orgRole","orgSlug","orgPermissions","factorVerificationAge","isAuthenticated",false,"tokenType","session_token","user","preferencesKeybindings","default","preferencesTheme","light","preferencesFixers","preferencesCopilot","preferencesSelectionAi","preferencesChatPanelState","notificationCount",0,"flagDenols","isBusinessOrgMember","isHigherTownieTier","ENV",{"_39":40,"_41":42,"_43":44,"_45":46,"_47":48,"_49":50,"_51":52,"_53":54,"_55":56,"_57":58,"_59":60,"_61":62,"_63":64,"_65":66,"_67":68},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","VAL_RUNTIME_NAME","prod","RENDER_GIT_COMMIT","efeea19332d9bfe7de1049656877be9cb817c45f","RENDER_GIT_BRANCH","main","CLERK_PUBLISHABLE_KEY","pk_live_Y2xlcmsudmFsLnRvd24k","POSTHOG_API_TOKEN","phc_nmoyuAkStEZuUp69rYlg1DZgrIt19Gx0Y4Hwf8tGgJP","POSTHOG_API_HOST","https://wart.val.town","WEB_API_TEMPLATE","https://{val}.web.val.run","APP_URL","https://www.val.town","MODULE_URL","https://esm.town","VANITY_WEB_API_TEMPLATE","https://{label}.val.run/","DENOLS_URL","https://lsp.val.town","NODE_ENV","production","CLOUDFLARE_TURNSTILE_SITE_KEY","0x4AAAAAACtaIZJH7s9rBMZ6","API_URL","https://api.val.town","clerkState",{"_71":72},"__internal_clerk_state",{"_73":74,"_75":48,"_76":77,"_78":77,"_79":20,"_80":77,"_81":77,"_82":77,"_83":77,"_84":85,"_94":20,"_95":20},"__clerk_ssr_state",{"_21":22,"_9":-5,"_10":-5,"_11":-5,"_12":-5,"_13":-5,"_14":-5,"_15":-5,"_16":-5,"_17":-5,"_18":-5,"_19":20},"__publishableKey","__proxyUrl","","__domain","__isSatellite","__signInUrl","__signUpUrl","__afterSignInUrl","__afterSignUpUrl","__clerk_debug",{"_86":20,"_19":20,"_87":77,"_88":89,"_90":77,"_91":48,"_92":20,"_93":77},"isSignedIn","proxyUrl","reason","session-token-and-uat-missing","message","publishableKey","isSatellite","domain","__telemetryDisabled","__telemetryDebug","routes/embed.x.$handle.$name.$",{"_98":99,"_100":101,"_102":103,"_104":105,"_161":162,"_178":179,"_180":-5},"handle","c15r","name","MCP","path","server.ts","project",{"_106":107,"_100":101,"_108":109,"_110":-5,"_111":20,"_112":113,"_114":115,"_116":-5,"_12":117,"_118":119,"_120":121,"_122":121,"_123":-5,"_124":33,"_14":125,"_126":-5,"_127":-5,"_128":-5,"_129":-5,"_130":131,"_132":131,"_133":134,"_135":134,"_136":134,"_137":131,"_138":131,"_23":139,"_142":143,"_147":148,"_160":20},"id","e1ff20a2-3b9c-11f0-96f0-9e149126039e","createdAt",["D",1748420544100],"deletedAt","legacyEnvVars","privacy","public","description","Lightweight MCP server lib for Val.town","imageUrl","21f2e37e-8066-4730-9dc7-d27cf8d3c9f3","pinnedFileId","81c497c6-3c0a-11f0-81e2-9e149126039e","pinPreview",true,"pinMigrated","screenshotVersion","likeCount","0630d977-f678-453e-926c-52043293f59f","tursoName","tursoHostname","tursoMeasuredAt","pinned","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm",{"_98":99,"_140":141},"profileImageUrl","https://img.clerk.com/eyJ0eXBlIjoicHJveHkiLCJzcmMiOiJodHRwczovL2ltYWdlcy5jbGVyay5kZXYvb2F1dGhfZ2l0aHViL2ltZ18yb2RJNlc1czZ1NlpZRmoxdGJ2eFVNNVhmeTYifQ","org",{"_98":99,"_144":141,"_12":117,"_145":146},"avatar","tier","pro","branch",{"_149":150,"_100":46,"_106":151,"_152":107,"_153":-5,"_154":-5,"_155":-5,"_156":-5,"_157":-5,"_158":101,"_159":99},"version",39,"e1ff5798-3b9c-11f0-96f0-9e149126039e","projectId","forkedBranchId","forkedBranchVersion","forkedProjectPrivacy","forkedProjectId","forkedProjectOrgId","projectName","userHandle","isOwned","file",{"_106":163,"_100":103,"_164":165,"_166":-5,"_167":151,"_168":150,"_169":121,"_108":170,"_149":33,"_171":172,"_173":174,"_175":20,"_176":-5,"_102":177},"da3ab122-32d3-11f1-ab31-42dde27851f2","fileId","da3ab1cc-32d3-11f1-ab31-42dde27851f2","parentId","branchId","branchVersion","latest",["D",1775602090581],"fileType","script","content","/**\n * @c15r/MCP — Lightweight MCP server framework for Val.town\n * \n * Provides the JSON-RPC 2.0 + CORS + routing boilerplate so you\n * only need to define your tools.\n * \n * Usage:\n * import { McpServer } from \"https://esm.town/v/c15r/MCP/server.ts\";\n * \n * const server = new McpServer({ name: \"my-server\", version: \"1.0.0\" });\n * \n * server.tool(\"greet\", \"Say hello\", {\n * type: \"object\",\n * properties: { name: { type: \"string\" } },\n * required: [\"name\"],\n * }, async (args) => `Hello, ${args.name}!`);\n * \n * export default server.handler();\n */\n\n// ─── Types ───────────────────────────────────────────────────────\n\nexport interface ToolAnnotations {\n readOnlyHint?: boolean;\n destructiveHint?: boolean;\n idempotentHint?: boolean;\n openWorldHint?: boolean;\n}\n\nexport interface Tool {\n name: string;\n description: string;\n inputSchema: Record;\n annotations?: ToolAnnotations;\n handler: (args: any, ctx?: any) => Promise> | string | Record;\n}\n\nexport interface McpServerOptions {\n name: string;\n version: string;\n description?: string;\n protocolVersion?: string;\n /** Optional auth check — return a context object or throw/return null to reject */\n authenticate?: (req: Request) => Promise;\n}\n\n// ─── JSON-RPC 2.0 ────────────────────────────────────────────────\n\ninterface JsonRpcRequest {\n jsonrpc: \"2.0\";\n id?: string | number;\n method: string;\n params?: any;\n}\n\ninterface JsonRpcResponse {\n jsonrpc: \"2.0\";\n id?: string | number | null;\n result?: unknown;\n error?: { code: number; message: string; data?: unknown };\n}\n\nfunction rpcResult(id: any, result: unknown): JsonRpcResponse {\n return { jsonrpc: \"2.0\", id: id ?? null, result };\n}\n\nfunction rpcError(id: any, code: number, message: string, data?: unknown): JsonRpcResponse {\n return { jsonrpc: \"2.0\", id: id ?? null, error: { code, message, ...(data !== undefined ? { data } : {}) } };\n}\n\n// ─── CORS ────────────────────────────────────────────────────────\n\nconst CORS: Record = {\n \"Access-Control-Allow-Origin\": \"*\",\n \"Access-Control-Allow-Methods\": \"GET, POST, DELETE, OPTIONS\",\n \"Access-Control-Allow-Headers\": \"Content-Type, Authorization, Mcp-Session-Id\",\n};\n\nfunction corsJson(data: unknown, status = 200): Response {\n return new Response(JSON.stringify(data, null, 2), {\n status,\n headers: { ...CORS, \"Content-Type\": \"application/json\" },\n });\n}\n\n// ─── Server ──────────────────────────────────────────────────────\n\nexport class McpServer {\n private tools: Tool[] = [];\n private opts: Required> & McpServerOptions;\n\n constructor(opts: McpServerOptions) {\n this.opts = { ...opts, protocolVersion: opts.protocolVersion ?? \"2025-03-26\" };\n }\n\n /** Register a tool */\n tool(\n name: string,\n description: string,\n inputSchema: Record,\n handler: Tool[\"handler\"],\n annotations?: ToolAnnotations,\n ): this {\n this.tools.push({ name, description, inputSchema, handler, annotations });\n return this;\n }\n\n /** Register a pre-built Tool object */\n addTool(tool: Tool): this {\n this.tools.push(tool);\n return this;\n }\n\n private toolsSchema() {\n return this.tools.map(t => ({\n name: t.name,\n description: t.description,\n inputSchema: t.inputSchema,\n ...(t.annotations ? { annotations: t.annotations } : {}),\n }));\n }\n\n private async handleRpc(req: JsonRpcRequest, ctx?: any): Promise {\n const { method, id, params } = req;\n\n if (method === \"initialize\") {\n return rpcResult(id, {\n protocolVersion: this.opts.protocolVersion,\n capabilities: { tools: {} },\n serverInfo: { name: this.opts.name, version: this.opts.version },\n });\n }\n\n if (method === \"notifications/initialized\" || method === \"ping\") {\n return rpcResult(id, {});\n }\n\n if (method === \"tools/list\") {\n return rpcResult(id, { tools: this.toolsSchema() });\n }\n\n if (method === \"tools/call\") {\n const toolName = params?.name;\n const toolArgs = params?.arguments ?? {};\n const tool = this.tools.find(t => t.name === toolName);\n if (!tool) return rpcError(id, -32602, `Unknown tool: ${toolName}`);\n try {\n const result = await tool.handler(toolArgs, ctx);\n return rpcResult(id, {\n content: [{\n type: \"text\",\n text: typeof result === \"string\" ? result : JSON.stringify(result, null, 2),\n }],\n });\n } catch (err: any) {\n return rpcResult(id, {\n content: [{ type: \"text\", text: `Error: ${err.message}` }],\n isError: true,\n });\n }\n }\n\n return rpcError(id, -32601, `Method not found: ${method}`);\n }\n\n /** Returns a `(req: Request) => Promise` HTTP handler */\n handler(): (req: Request) => Promise {\n return async (req: Request): Promise => {\n const url = new URL(req.url);\n const path = url.pathname;\n\n if (req.method === \"OPTIONS\") {\n return new Response(null, { headers: CORS });\n }\n\n // GET — server info\n if (req.method === \"GET\" && (path === \"/mcp\" || path === \"/\")) {\n return corsJson({\n name: this.opts.name,\n version: this.opts.version,\n protocol: \"MCP\",\n protocolVersion: this.opts.protocolVersion,\n transport: \"streamable-http\",\n tools: this.tools.map(t => t.name),\n ...(this.opts.description ? { description: this.opts.description } : {}),\n });\n }\n\n // DELETE — session teardown (stateless, no-op)\n if (req.method === \"DELETE\") {\n return new Response(null, { status: 200, headers: CORS });\n }\n\n // POST — JSON-RPC\n if (req.method === \"POST\" && (path === \"/mcp\" || path === \"/\")) {\n // Optional auth\n let ctx: any = undefined;\n if (this.opts.authenticate) {\n try {\n ctx = await this.opts.authenticate(req);\n if (ctx === null) {\n return corsJson({ error: \"unauthorized\" }, 401);\n }\n } catch (e: any) {\n return corsJson({ error: \"unauthorized\", message: e.message }, 401);\n }\n }\n\n let body: unknown;\n try { body = await req.json(); }\n catch {\n return new Response(JSON.stringify(rpcError(null, -32700, \"Parse error\")), {\n status: 400, headers: { ...CORS, \"Content-Type\": \"application/json\" },\n });\n }\n\n if (Array.isArray(body)) {\n const responses = await Promise.all(\n (body as JsonRpcRequest[]).map(r => this.handleRpc(r, ctx))\n );\n return corsJson(responses);\n }\n\n const response = await this.handleRpc(body as JsonRpcRequest, ctx);\n return corsJson(response);\n }\n\n return corsJson({ error: \"Not found. POST JSON-RPC to /mcp\" }, 404);\n };\n }\n}\n","deleted","label",[103],"permalink","https://www.val.town/x/c15r/MCP/code/server.ts","extension","actionData","errors"]