AminA Character Studio

[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_182":183,"_184":185},"routes/_app.x.$handle.$name",{"_11":12,"_13":14,"_15":-7,"_18":19,"_17":-7,"_136":-5,"_20":137,"_22":138,"_139":140,"_141":142,"_26":143,"_24":144,"_145":146,"_147":148,"_149":51,"_150":151,"_152":81,"_153":-5,"_154":-5,"_155":156},"routes/_app.x.$handle.$name.code.$",{"_11":12,"_13":14,"_15":16,"_17":-7,"_18":19,"_20":21,"_22":23,"_24":25,"_26":27,"_28":29,"_30":-5,"_31":32,"_33":34,"_35":-5},"handle","aminfarhang","name","amina-character-studio-plugin","branchName","main","version","path","README.md","project",{"_36":92,"_13":14,"_38":93,"_49":-5,"_94":51,"_52":53,"_95":53,"_96":97,"_98":-5,"_99":100,"_101":78,"_102":51,"_103":-5,"_104":-5,"_105":67,"_55":56,"_106":-5,"_107":-5,"_108":-5,"_109":-5,"_110":111,"_112":111,"_113":114,"_115":114,"_116":114,"_117":111,"_118":111,"_119":120,"_121":122,"_123":124,"_50":51},"tree",[74,75],"file",{"_36":59,"_60":61,"_62":63,"_13":19,"_64":65,"_66":24,"_17":67,"_68":-5,"_38":69,"_70":71,"_72":-5,"_18":73},"contents",[],"upstream",{"_36":37,"_38":39,"_40":41,"_13":16,"_42":43,"_17":44,"_45":-5,"_46":-5,"_47":48,"_49":-5,"_50":51,"_52":53,"_54":12,"_55":56,"_57":58},"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","71540e14-6f1c-474f-a3f4-0b8707d6b4f6","branchId","6c2c6b1e-833b-49ef-86ee-377558e10bc5","fileId","01a0a4ce-0e3e-7033-86bd-6ee0de657ed0","content","# 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.","fileType",0,"parentId",["D",1789471362559],"branchVersion",1,"label",[19],{"_36":59,"_13":19,"_62":63,"_68":-5,"_60":61,"_70":71,"_80":81,"_38":89,"_17":67,"_66":24,"_64":65,"_85":51,"_72":-5,"_86":90,"_18":91},{"_36":76,"_13":77,"_62":78,"_68":-5,"_60":61,"_70":79,"_80":81,"_38":82,"_17":32,"_66":83,"_64":84,"_85":51,"_72":14,"_86":87,"_18":88},"1def8831-8cd0-4201-82ab-d0dce3e15e90","main.ts","01a0a4ce-0e3e-7033-86bd-712002284b81",5,"latest",true,["D",1789475979314],"http","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","children",[],[77],["D",1789471362559],[],[19],"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,"_135":131},"org",{"_11":12,"_128":129,"_130":131,"_99":100,"_132":133,"_134":51},"branch",{"_17":79,"_13":16,"_36":61,"_42":92,"_45":37,"_46":79,"_125":53,"_126":43,"_127":56,"_57":14,"_54":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",{"_36":92,"_13":14,"_38":178,"_49":-5,"_94":51,"_52":53,"_95":53,"_96":97,"_98":-5,"_99":100,"_101":78,"_102":51,"_103":-5,"_104":-5,"_105":67,"_55":56,"_106":-5,"_107":-5,"_108":-5,"_109":-5,"_110":111,"_112":111,"_113":114,"_115":114,"_116":114,"_117":111,"_118":111,"_119":179,"_121":180,"_123":181,"_50":51},[172,173],"files",[172,173],"counts",{"_163":67,"_164":71,"_165":67,"_35":166,"_167":168},[],{"_36":59,"_13":19,"_62":63,"_68":-5,"_60":61,"_70":71,"_80":81,"_38":161,"_17":67,"_66":24,"_64":65,"_85":51,"_72":-5,"_18":162},"upstreamProject",{"_36":43,"_13":58,"_96":159,"_98":-5,"_52":53,"_119":160},"upstreamBranch",{"_36":37,"_38":157,"_40":158,"_13":16,"_42":43,"_17":44,"_45":-5,"_46":-5,"_47":48,"_49":-5,"_50":51,"_52":53,"_54":12,"_55":56,"_57":58},"emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},["D",1789468673039],["D",1789550553221],"AminA Character Studio MCP connector",{"_11":12,"_135":131},["D",1789471362559],[19],"pulls","branches","forks",{"_169":67,"_171":67},"connections",{"_169":67,"_170":67},"count","unfilledCount","emptyCount",{"_36":59,"_13":19,"_62":63,"_68":-5,"_60":61,"_70":71,"_80":81,"_38":89,"_17":67,"_66":24,"_64":65,"_85":51,"_72":-5,"_86":176,"_18":177},{"_36":76,"_13":77,"_62":78,"_68":-5,"_60":61,"_70":79,"_80":81,"_38":82,"_17":32,"_66":83,"_64":84,"_85":51,"_72":14,"_86":174,"_18":175},[],[77],[],[19],["D",1789471362559],{"_11":12,"_135":131},{"_11":12,"_128":129,"_130":131,"_99":100,"_132":133,"_134":51},{"_17":79,"_13":16,"_36":61,"_42":92,"_45":37,"_46":79,"_125":53,"_126":43,"_127":56,"_57":14,"_54":12},"ctx",{"_119":-5,"_154":215,"_216":217,"_218":219,"_220":51,"_221":51,"_222":51,"_223":81,"_224":-5,"_225":-7,"_226":-7,"_227":67,"_228":51,"_229":51,"_230":-5,"_231":51,"_232":51,"_233":51,"_234":-5},"ENV",{"_186":187,"_188":189,"_190":16,"_191":192,"_193":194,"_195":196,"_197":198,"_199":200,"_201":202,"_203":204,"_205":206,"_207":208,"_209":210,"_211":212,"_213":214},"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"]