AminA Character Studio

[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_178":179,"_180":181},"routes/_app.x.$handle.$name",{"_101":100,"_32":49,"_110":89,"_27":111,"_13":14,"_112":-5,"_11":113,"_114":115,"_116":117,"_118":119,"_120":121,"_21":-5,"_122":123,"_124":125,"_126":25,"_127":128,"_129":130,"_131":-5,"_132":-5,"_133":134},"routes/_app.x.$handle.$name.branch.$branch.version.$version.diff",{"_11":12,"_13":14,"_15":16,"_17":-5,"_18":-5},"project",{"_47":48,"_32":49,"_37":50,"_51":-5,"_52":25,"_53":54,"_55":54,"_56":57,"_58":-5,"_18":59,"_60":31,"_61":25,"_62":-5,"_63":-5,"_64":65,"_66":67,"_68":-5,"_69":-5,"_70":-5,"_71":-5,"_72":73,"_74":73,"_75":76,"_77":76,"_78":76,"_79":73,"_80":73,"_81":82,"_83":84,"_85":86,"_87":25},"version",1,"changes",[19,20],"aiChatInfo","userId",{"_21":42,"_23":-7,"_24":25,"_26":25,"_27":43,"_29":43},{"_21":22,"_23":-7,"_24":25,"_26":25,"_27":28,"_29":28},"file",{"_30":31,"_32":28,"_33":34,"_35":36,"_37":38,"_39":14,"_40":41,"_24":25},"previous","deleted",false,"deletedHere","path","main.ts","latestPath","fileId","01a0a4ce-0e3e-7033-86bd-712002284b81","name","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/v4.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\": LEGACY_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;","createdAt",["D",1789471362559],"branchVersion","branchId","6c2c6b1e-833b-49ef-86ee-377558e10bc5",{"_30":44,"_32":43,"_33":21,"_35":45,"_37":46,"_39":14,"_40":41,"_24":25},"README.md","01a0a4ce-0e3e-7033-86bd-6ee0de657ed0","# 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.",["D",1789471362559],"id","b013bd07-9441-4335-bf4d-3f3af6e81956","amina-character-studio-plugin",["D",1789471362559],"deletedAt","legacyEnvVars","privacy","public","httpPrivacy","description","AminA Character Studio inline MCP app","imageUrl","6bc8f6e0-3727-4cbc-8f9c-2f9aeae69fe5","pinnedFileId","pinPreview","pinMigrated","screenshotVersion","likeCount",0,"orgId","01a03ebf-08c8-77b5-b4dd-c31c30a28471","tursoName","tursoHostname","tursoMeasuredAt","pinned","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm","user",{"_101":100,"_109":105},"org",{"_101":100,"_102":103,"_104":105,"_18":59,"_106":107,"_108":25},"branch",{"_13":88,"_32":89,"_47":41,"_90":48,"_91":92,"_93":88,"_94":54,"_95":96,"_97":67,"_98":49,"_99":100},"isOwned",5,"main","projectId","forkedBranchId","f939d1fe-d3f8-4622-a5b1-592e879513ae","forkedBranchVersion","forkedProjectPrivacy","forkedProjectId","dc114f61-c059-4b89-844f-52938e231c8e","forkedProjectOrgId","projectName","userHandle","aminfarhang","handle","displayName","Amin Farhang","avatar","https://lh3.googleusercontent.com/a/ACg8ocKps617N1S-6o5-02GdgzyG_1AxQNZEtCK_Yne1OA9Ob8Fx4BY=s96-c","tier","free","canRestrictVals","profileImageUrl","branchName","","adoptOrgId",{"_47":48,"_32":49,"_37":174,"_51":-5,"_52":25,"_53":54,"_55":54,"_56":57,"_58":-5,"_18":59,"_60":31,"_61":25,"_62":-5,"_63":-5,"_64":65,"_66":67,"_68":-5,"_69":-5,"_70":-5,"_71":-5,"_72":73,"_74":73,"_75":76,"_77":76,"_78":76,"_79":73,"_80":73,"_81":175,"_83":176,"_85":177,"_87":25},"tree",[165,166],"files",[165,166],"counts",{"_155":65,"_156":14,"_157":65,"_158":159,"_160":161},"contents",[144,145],"upstreamProject",{"_47":96,"_32":141,"_56":142,"_58":-5,"_53":54,"_81":143},"upstreamBranch",{"_47":92,"_37":135,"_136":137,"_32":89,"_90":96,"_13":138,"_91":-5,"_93":-5,"_139":140,"_51":-5,"_87":25,"_53":54,"_99":100,"_66":67,"_98":141},"emptyEnvVars","flags",[],"hasHttpFiles",true,"grants","orgs","customDomains",{},["D",1789468673039],"updatedAt",["D",1789550553221],80,"lockfileKey","1789550553430-esm.town_v_aminfarhang_amina-character-studio-mcp@80-main","amina-character-studio-mcp","AminA Character Studio MCP connector",{"_101":100,"_109":105},{"_47":152,"_32":43,"_30":44,"_147":-5,"_40":41,"_39":14,"_148":130,"_37":153,"_13":65,"_33":21,"_35":45,"_24":25,"_150":-5,"_27":154},{"_47":146,"_32":28,"_30":31,"_147":-5,"_40":41,"_39":14,"_148":25,"_37":149,"_13":65,"_33":34,"_35":36,"_24":25,"_150":49,"_27":151},"ddc41fca-bca2-4a5b-bc8c-ea8488ddab48","parentId","latest",["D",1789471362559],"label",[28],"71540e14-6f1c-474f-a3f4-0b8707d6b4f6",["D",1789471362559],[43],"pulls","branches","forks","envVars",{"_162":65,"_164":65},"connections",{"_162":65,"_163":65},"count","unfilledCount","emptyCount",{"_47":152,"_32":43,"_30":44,"_147":-5,"_40":41,"_39":14,"_148":130,"_37":171,"_13":65,"_33":21,"_35":45,"_24":25,"_150":-5,"_168":172,"_27":173},{"_47":146,"_32":28,"_30":31,"_147":-5,"_40":41,"_39":14,"_148":25,"_37":167,"_13":65,"_33":34,"_35":36,"_24":25,"_150":49,"_168":169,"_27":170},["D",1789471362559],"children",[],[28],["D",1789471362559],[],[43],["D",1789471362559],{"_101":100,"_109":105},{"_101":100,"_102":103,"_104":105,"_18":59,"_106":107,"_108":25},{"_13":88,"_32":89,"_47":41,"_90":48,"_91":92,"_93":88,"_94":54,"_95":96,"_97":67,"_98":49,"_99":100},"ctx",{"_81":-5,"_132":211,"_212":213,"_214":215,"_216":25,"_217":25,"_218":25,"_219":130,"_220":-5,"_221":-7,"_222":-7,"_223":65,"_224":25,"_225":25,"_226":-5,"_227":25,"_228":25,"_229":25,"_230":-5},"ENV",{"_182":183,"_184":185,"_186":89,"_187":188,"_189":190,"_191":192,"_193":194,"_195":196,"_197":198,"_199":200,"_201":202,"_203":204,"_205":206,"_207":208,"_209":210},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","fdb67791413f4386b4dbf18f354029a617f6160f","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"]

Diff · v1