AminA Character Studio

[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_187":188,"_189":190},"routes/_app.x.$handle.$name",{"_11":12,"_13":14,"_15":16,"_18":19,"_17":-7,"_140":-5,"_20":141,"_22":142,"_143":144,"_145":146,"_25":147,"_24":-5,"_148":149,"_150":151,"_152":50,"_153":154,"_155":70,"_156":-5,"_157":-5,"_158":159},"routes/_app.x.$handle.$name.branch.$branch.code.$",{"_11":12,"_13":14,"_15":16,"_17":-7,"_18":19,"_20":21,"_22":23,"_24":-7,"_25":26,"_27":28,"_29":-5,"_30":31,"_32":33,"_34":-5},"handle","aminfarhang","name","amina-character-studio-plugin","branchName","main","version","path","","project",{"_35":96,"_13":14,"_37":97,"_48":-5,"_98":50,"_51":52,"_99":52,"_100":101,"_102":-5,"_103":104,"_105":63,"_106":50,"_107":-5,"_108":-5,"_109":84,"_54":55,"_110":-5,"_111":-5,"_112":-5,"_113":-5,"_114":115,"_116":115,"_117":118,"_119":118,"_120":118,"_121":115,"_122":115,"_123":124,"_125":126,"_127":128,"_49":50},"tree",[87,88],"file","contents",[58,59],"upstream",{"_35":36,"_37":38,"_39":40,"_13":16,"_41":42,"_17":43,"_44":-5,"_45":-5,"_46":47,"_48":-5,"_49":50,"_51":52,"_53":12,"_54":55,"_56":57},"pull","ahead",4,"behind",75,"envVars","id","f939d1fe-d3f8-4622-a5b1-592e879513ae","createdAt",["D",1789468673039],"updatedAt",["D",1789550553221],"projectId","dc114f61-c059-4b89-844f-52938e231c8e",80,"forkedBranchId","forkedBranchVersion","lockfileKey","1789550553430-esm.town_v_aminfarhang_amina-character-studio-mcp@80-main","deletedAt","isOwned",false,"privacy","public","userHandle","orgId","01a03ebf-08c8-77b5-b4dd-c31c30a28471","projectName","amina-character-studio-mcp",{"_35":79,"_13":80,"_62":81,"_64":-5,"_65":66,"_67":82,"_69":70,"_37":83,"_17":84,"_72":24,"_74":85,"_76":50,"_77":-5,"_18":86},{"_35":60,"_13":61,"_62":63,"_64":-5,"_65":66,"_67":68,"_69":70,"_37":71,"_17":31,"_72":73,"_74":75,"_76":50,"_77":14,"_18":78},"1def8831-8cd0-4201-82ab-d0dce3e15e90","main.ts","fileId","01a0a4ce-0e3e-7033-86bd-712002284b81","parentId","branchId","6c2c6b1e-833b-49ef-86ee-377558e10bc5","branchVersion",5,"latest",true,["D",1789475979314],"fileType","http","content","import {\n createMcpHandler,\n McpServer,\n} from \"npm:@modelcontextprotocol/server@2\";\nimport * as z from \"npm:zod@4/v4\";\nimport { registerAppResource, registerAppTool, RESOURCE_MIME_TYPE } from \"npm:@modelcontextprotocol/ext-apps/server\";\n\nconst STUDIO_URL = \"https://amina-character-studio.ruholamin.chatgpt.site\";\nconst TEMPLATE_URI = \"ui://amina-character-studio/v5.html\";\nconst LEGACY_TEMPLATE_URI = \"ui://amina-character-studio/v4-skybridge.html\";\nconst widgetHtml = \"\\n\\n\\n\\n\\nAminA Character Studio\\n\\n\\n\\n

\\n

AminARECORDS

Character Studio

● ChatGPT connected

\\n \\n

\\n

Character references

Identity only · up to 10 files

0/10

\\n ＋ Add character referencesSingle photos or reference collages\\n

\\n \\n \\n

\\n

Destinations

Scene, pose, outfit and style

0/10

\\n ＋ Add destination imagesEach image becomes one separate output\\n

\\n

Generation queue

Continuous · no confirmation stops

\\n

No collage. One destination equals one standalone result. Failed items retry independently.

\\n \\n

\\n

Results ready

Select only the images you want to upscale

\\n

0 selected

\\n

\\n External fallback ↗\\n

\\n

\\n\\n\\n\";\n\nconst handler = createMcpHandler(() => {\n const server = new McpServer({ name: \"amina-character-studio\", version: \"1.3.0\" });\n\n const resourceMeta = {\n ui: {\n prefersBorder: true,\n domain: \"https://amina-character-studio-plugin.val.run\",\n csp: { connectDomains: [], resourceDomains: [] },\n },\n \"openai/widgetDescription\": \"Interactive AminA Character Studio for identity-locked character transfer and selective upscaling.\",\n \"openai/widgetPrefersBorder\": true,\n \"openai/widgetDomain\": \"https://amina-character-studio-plugin.val.run\",\n \"openai/widgetCSP\": {\n connect_domains: [],\n resource_domains: [],\n redirect_domains: [STUDIO_URL],\n },\n };\n\n registerAppResource(server, \"amina-character-studio-widget\", TEMPLATE_URI, {}, async () => ({\n contents: [{\n uri: TEMPLATE_URI,\n mimeType: RESOURCE_MIME_TYPE,\n text: widgetHtml,\n _meta: resourceMeta,\n }],\n }));\n\n server.registerResource(\"amina-character-studio-widget-skybridge\", LEGACY_TEMPLATE_URI, {}, async () => ({\n contents: [{\n uri: LEGACY_TEMPLATE_URI,\n mimeType: \"text/html+skybridge\",\n text: widgetHtml,\n _meta: resourceMeta,\n }],\n }));\n\n const openStudioDescriptor = {\n title: \"Open AminA Character Studio\",\n description: \"Render the interactive AminA Character Studio directly inside the ChatGPT conversation. This is the primary UI-rendering tool.\",\n inputSchema: z.object({}),\n outputSchema: z.object({\n mode: z.literal(\"embedded\"),\n studioUrl: z.string().url(),\n ready: z.boolean(),\n }),\n annotations: { readOnlyHint: true, destructiveHint: false, openWorldHint: false, idempotentHint: true },\n _meta: {\n ui: { resourceUri: TEMPLATE_URI, visibility: [\"model\", \"app\"] },\n \"openai/outputTemplate\": TEMPLATE_URI,\n \"openai/widgetAccessible\": true,\n \"openai/toolInvocation/invoking\": \"Opening Character Studio…\",\n \"openai/toolInvocation/invoked\": \"Character Studio ready\",\n },\n };\n\n const openStudioHandler = () => ({\n structuredContent: { mode: \"embedded\" as const, studioUrl: STUDIO_URL, ready: true },\n content: [{ type: \"text\" as const, text: \"AminA Character Studio is mounted as an interactive inline component. The external URL is fallback only.\" }],\n });\n\n registerAppTool(server, \"open_character_studio\", openStudioDescriptor, openStudioHandler);\n registerAppTool(server, \"open_character_studio_ui\", {\n ...openStudioDescriptor,\n title: \"Render AminA Character Studio UI\",\n description: \"Explicitly render the interactive AminA Character Studio component inline. Use this if a cached client treated open_character_studio as text-only.\",\n }, openStudioHandler);\n\n server.registerTool(\"prepare_character_batch\", {\n description: \"Prepare an uninterrupted identity-locked character transfer batch using images attached in the current ChatGPT conversation.\",\n inputSchema: z.object({\n referenceCount: z.number().int().min(1).max(10),\n destinationCount: z.number().int().min(1).max(10),\n subject: z.enum([\"woman\", \"man\", \"both\", \"main-subject\"]).default(\"main-subject\"),\n additionalInstruction: z.string().max(2000).optional(),\n }),\n }, ({ referenceCount, destinationCount, subject, additionalInstruction }) => ({\n content: [{ type: \"text\", text: [\n \"AMINA CHARACTER BATCH READY.\",\n \"References: \" + referenceCount + \"; destinations: \" + destinationCount + \"; subject mapping: \" + subject + \".\",\n \"Use the attached reference files only to lock identity. A reference file may itself be a collage.\",\n \"Use each destination for pose, framing, camera angle, gaze, expression, outfit and coverage, lighting, environment, occlusion, body presentation, and visual medium.\",\n \"Generate exactly \" + destinationCount + \" independent full-frame outputs: one destination equals one separate result.\",\n \"Never create a collage, grid, montage, contact sheet, split screen, or storyboard.\",\n \"Run one continuous batch without confirmation stops. Retry only a failed item and continue the remaining items.\",\n \"Match the destination medium. For photographs use maximum-quality photorealistic natural texture; for illustrations render the locked identity in that same style.\",\n \"Keep anatomy and posture plausible and natural.\",\n additionalInstruction ? \"Additional instruction: \" + additionalInstruction : \"Additional instruction: none.\",\n \"Use the native image generation/editing capability available in this ChatGPT session; do not request an API key for this workflow.\",\n \"Visual workspace: \" + STUDIO_URL,\n ].join(\"\\n\") }],\n }));\n\n server.registerTool(\"prepare_upscale_batch\", {\n description: \"Prepare a separate 2x or 4x upscale batch for only the completed results selected by the user.\",\n inputSchema: z.object({\n selectedCount: z.number().int().min(1).max(10),\n factor: z.enum([\"2x\", \"4x\"]),\n }),\n }, ({ selectedCount, factor }) => ({\n content: [{ type: \"text\", text: [\n \"UPSCALE BATCH READY: \" + selectedCount + \" selected result(s), \" + factor + \".\",\n \"Upscale only the selected completed results as one uninterrupted batch.\",\n \"Return each enhanced image as a separate file.\",\n \"Preserve identity, face, composition, skin texture, anatomy, styling, and destination constraints.\",\n \"Enhance resolution and natural detail only; do not reshape, recombine, or regenerate the scene.\",\n ].join(\"\\n\") }],\n }));\n\n return server;\n});\n\nexport default handler.fetch;","deleted","label",[61],"71540e14-6f1c-474f-a3f4-0b8707d6b4f6","README.md","01a0a4ce-0e3e-7033-86bd-6ee0de657ed0",1,["D",1789471362559],0,"# MCP server\n\n_In video form:\n[How to build an MCP server in 1 minute](https://youtu.be/sO6-Wl5fy7g?si=oc7s9bVIVFHxHJh2)_\n\nA minimal MCP server with one example tool (that gets the current time in a\ngiven timezone).\n\nRemix this val to create your own MCP server on Val\nTown—[**_just like the MCP Core Maintainer team!_**](https://blog.val.town/mcp-core-maintainers)\n\nThis MCP server (<50 LOC in [`main.ts`](./main.ts)) is live on\n[mcp-time.val.run](https://mcp-time.val.run) if you'd like to test it\n([playground.ai.cloudflare.com](https://playground.ai.cloudflare.com) is a great\nplace to test an MCP server quickly). It's built on the v2 TypeScript SDK,\ncompatible with “MCP 2.0” (technically, the\n[2026-07-28 spec](https://modelcontextprotocol.io/specification/2026-07-28)). It\nalso supports the legacy spec, for MCP clients that haven't upgraded yet.",[80],{"_35":79,"_13":80,"_62":81,"_64":-5,"_65":66,"_67":82,"_69":70,"_37":93,"_17":84,"_72":24,"_74":85,"_76":50,"_77":-5,"_90":94,"_18":95},{"_35":60,"_13":61,"_62":63,"_64":-5,"_65":66,"_67":68,"_69":70,"_37":89,"_17":31,"_72":73,"_74":75,"_76":50,"_77":14,"_90":91,"_18":92},["D",1789475979314],"children",[],[61],["D",1789471362559],[],[80],"b013bd07-9441-4335-bf4d-3f3af6e81956",["D",1789471362559],"legacyEnvVars","httpPrivacy","description","AminA Character Studio inline MCP app","imageUrl","userId","6bc8f6e0-3727-4cbc-8f9c-2f9aeae69fe5","pinnedFileId","pinPreview","pinMigrated","screenshotVersion","likeCount","tursoName","tursoHostname","tursoMeasuredAt","pinned","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm","user",{"_11":12,"_139":135},"org",{"_11":12,"_132":133,"_134":135,"_103":104,"_136":137,"_138":50},"branch",{"_17":68,"_13":16,"_35":66,"_41":96,"_44":36,"_45":68,"_129":52,"_130":42,"_131":55,"_56":14,"_53":12},"forkedProjectPrivacy","forkedProjectId","forkedProjectOrgId","displayName","Amin Farhang","avatar","https://lh3.googleusercontent.com/a/ACg8ocKps617N1S-6o5-02GdgzyG_1AxQNZEtCK_Yne1OA9Ob8Fx4BY=s96-c","tier","free","canRestrictVals","profileImageUrl","adoptOrgId",{"_35":96,"_13":14,"_37":183,"_48":-5,"_98":50,"_51":52,"_99":52,"_100":101,"_102":-5,"_103":104,"_105":63,"_106":50,"_107":-5,"_108":-5,"_109":84,"_54":55,"_110":-5,"_111":-5,"_112":-5,"_113":-5,"_114":115,"_116":115,"_117":118,"_119":118,"_120":118,"_121":115,"_122":115,"_123":184,"_125":185,"_127":186,"_49":50},[177,178],"files",[177,178],"counts",{"_168":84,"_169":82,"_170":84,"_34":171,"_172":173},[164,165],"upstreamProject",{"_35":42,"_13":57,"_100":162,"_102":-5,"_51":52,"_123":163},"upstreamBranch",{"_35":36,"_37":160,"_39":161,"_13":16,"_41":42,"_17":43,"_44":-5,"_45":-5,"_46":47,"_48":-5,"_49":50,"_51":52,"_53":12,"_54":55,"_56":57},"emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},["D",1789468673039],["D",1789550553221],"AminA Character Studio MCP connector",{"_11":12,"_139":135},{"_35":79,"_13":80,"_62":81,"_64":-5,"_65":66,"_67":82,"_69":70,"_37":83,"_17":84,"_72":24,"_74":85,"_76":50,"_77":-5,"_18":167},{"_35":60,"_13":61,"_62":63,"_64":-5,"_65":66,"_67":68,"_69":70,"_37":71,"_17":31,"_72":73,"_74":75,"_76":50,"_77":14,"_18":166},[61],[80],"pulls","branches","forks",{"_174":84,"_176":84},"connections",{"_174":84,"_175":84},"count","unfilledCount","emptyCount",{"_35":79,"_13":80,"_62":81,"_64":-5,"_65":66,"_67":82,"_69":70,"_37":93,"_17":84,"_72":24,"_74":85,"_76":50,"_77":-5,"_90":181,"_18":182},{"_35":60,"_13":61,"_62":63,"_64":-5,"_65":66,"_67":68,"_69":70,"_37":89,"_17":31,"_72":73,"_74":75,"_76":50,"_77":14,"_90":179,"_18":180},[],[61],[],[80],["D",1789471362559],{"_11":12,"_139":135},{"_11":12,"_132":133,"_134":135,"_103":104,"_136":137,"_138":50},{"_17":68,"_13":16,"_35":66,"_41":96,"_44":36,"_45":68,"_129":52,"_130":42,"_131":55,"_56":14,"_53":12},"ctx",{"_123":-5,"_157":220,"_221":222,"_223":224,"_225":50,"_226":50,"_227":50,"_228":70,"_229":-5,"_230":-7,"_231":-7,"_232":84,"_233":50,"_234":50,"_235":-5,"_236":50,"_237":50,"_238":50,"_239":-5},"ENV",{"_191":192,"_193":194,"_195":16,"_196":197,"_198":199,"_200":201,"_202":203,"_204":205,"_206":207,"_208":209,"_210":211,"_212":213,"_214":215,"_216":217,"_218":219},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","e87eb04e707cf64e7e532c8e8ec395f209e17f15","RENDER_GIT_BRANCH","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","GOOGLE_CLIENT_ID","875989696899-jtsqkhlbdv5jrlsk8631p7ipjg3c6o62.apps.googleusercontent.com","STRIPE_PUBLISHABLE_KEY","pk_live_51N2zvWEpZTTLipIkVEwXrUG9AT0yeOOEYxszarZT1jpsZV58Ly6wlg3SltZpHN26CUalOBmUSY7adQRQiSkCZz2500qSXNkf8Y","API_URL","https://api.val.town",[],"preferencesKeybindings","default","preferencesTheme","light","preferencesFixers","preferencesCopilot","preferencesSelectionAi","preferencesCloseBrackets","preferencesChatPanelState","preferencesDprint","preferencesDenofmt","notificationCount","flagDenols","isBusinessOrgMember","businessOrgHandle","isBusinessOrgAdmin","isHigherTownieTier","navCollapsed","currentOrgId"]

Code