G
gdhub-io/character-forge-mcp
MCP server and Claude Code plugin: characters whose every trait grows from one story — then concept art, scene, video, voice and music.
★ 1·updated 2026-11-19
View on GitHub ↗Direct link · no redirect page
After install: how to tell it works
- What you see after install — The command exits 0 and the terminal shows no "command not found" or "permission denied".
- One-line self-check — Run the smallest usage example from that repository's README. If the output matches what the README describes, it is working.
- If that does not work — This project has no troubleshooting notes. Search its issues for "install".
The install command comes from the repository; these checks describe observable results only and do not replace the project's own docs.
- Star count
- 1 ★ · gdhub-io/character-forge-mcp · read from the GitHub search API · (checked 2026-11-19 20:00:48)
- Source
- read directly from its GitHub page · type: open-source project
- Harvest history
- first seen 2026-11-20 · last seen 2026-11-20 · seen 1× · listed by 1 sources
- Score
- score 103 · 1 ★ · 1 sources · repo
- Install
- see Install & config above
FAQ (answers come from our records)
Who is it for?
We filed it under these tags: Open Source. The tags come from the entry itself, not a taxonomy we imposed.
Who maintains it?
repository
gdhub-io/character-forge-mcp;first catalogued 2026-11-20;last seen 2026-11-20。There is no official certification or quality rating here — we record sources and dates only.README excerpt (English, untranslated) · Read the full README on GitHub →
# character-forge-mcp
Excerpted from the repository README (abridged)
A character studio inside your AI chat. Ask for a character for your film, game, ad or book, and get a whole person whose story holds together: what they want, what they fear, where they come from, how they change, and how they look. Then, if you like, see them, hear them and give them their own music.
See characters made with it: characters.gdhub.io
## Install
It runs on your computer and works with Claude Code, Codex and other AI apps. You need Node.js 20 or newer.
### Claude Code
Type these two commands in Claude Code:
/plugin marketplace add gdhub-io/character-forge-mcp
/plugin install character-forge@character-forge
It asks for a fal.ai key. You can leave it empty and add it later in /plugin.
### Codex
1. In a terminal, install it:
bash
npm install -g @gdhub/character-forge-mcp
2. In Codex, add an MCP server:
Command to launch:
Mac with Apple chip: /opt/homebrew/bin/character-forge
Mac with Intel chip, Linux: /usr/local/bin/character-forge
Windows: C:\Users\you\AppData\Roaming\npm\character-forge.cmd
If it isn't there (for example, Node is installed with nvm), run which character-forge on Mac or Linux, or where character-forge on Windows, and use what it prints.
Environment variables: CHARACTER_FORGE_DIR = /Users/you/character-forge (any folder for your characters), and FAL_KEY = your fal.ai key, if you have one
### Other AI apps
Claude Desktop, Cursor, VS Code and other apps that run MCP servers on your computer: add this to their MCP settings.
json
"mcpServers": {
"character-forge": {
"command": "npx",
"args": ["-y", "@gdhub/character-forge-mcp"],
"env": {
"CHARACTER_FORGE_DIR": "/Users/you/character-forge",
"FAL_KEY": "..."
### Remove it
Claude Code: /plugin uninstall character-forge@character-forge, then /plugin marketplace remove character-forge
Codex: delete the server in Codex's settings, then npm uninstall -g @gdhub/character-forge-mcp
Other apps: delete the character-forge entry from their MCP settings
Your characters stay in their folder until you delete it yourself.
## Use
Restart the app and ask in the chat:
> Make me a random character for a noir film.
> A 60-year-old ex-boxer for a coffee ad, warm but stubborn.
> Here's my sketch: hero.png. She's a desert pilot who is afraid of the sea.
You get a full character card. Then ask for more, one step at a time: "Draw the concept" (it comes with a face-centred avatar for free), "Put her in her place", "Bring the picture to life", "Give her a voice", "Write her music". Not sure what's next? Ask "What's next?".
Experimental: characters meet. In Claude Code, type /meet with 2–5 saved characters and a situation, for example /meet marta-vell pike-ostrander — stuck in a lift at night, the light goes out. They meet as strangers and play the scene in turns. You get a script with each one's private thoughts under their lines, and how each one's feelings toward the others changed. Free: the chat plays the characters.
Free: characters, cards, translations, and ready-made prompts you can use in any image, video, voice or music generator.
Paid: pictures, video, voice and music, made with your own fal.ai key. A whole character costs about $1.50. Nothing paid happens until you ask for it.
See characters made with it: characters.gdhub.io
## Install
It runs on your computer and works with Claude Code, Codex and other AI apps. You need Node.js 20 or newer.
### Claude Code
Type these two commands in Claude Code:
/plugin marketplace add gdhub-io/character-forge-mcp
/plugin install character-forge@character-forge
It asks for a fal.ai key. You can leave it empty and add it later in /plugin.
### Codex
1. In a terminal, install it:
bash
npm install -g @gdhub/character-forge-mcp
2. In Codex, add an MCP server:
Command to launch:
Mac with Apple chip: /opt/homebrew/bin/character-forge
Mac with Intel chip, Linux: /usr/local/bin/character-forge
Windows: C:\Users\you\AppData\Roaming\npm\character-forge.cmd
If it isn't there (for example, Node is installed with nvm), run which character-forge on Mac or Linux, or where character-forge on Windows, and use what it prints.
Environment variables: CHARACTER_FORGE_DIR = /Users/you/character-forge (any folder for your characters), and FAL_KEY = your fal.ai key, if you have one
### Other AI apps
Claude Desktop, Cursor, VS Code and other apps that run MCP servers on your computer: add this to their MCP settings.
json
"mcpServers": {
"character-forge": {
"command": "npx",
"args": ["-y", "@gdhub/character-forge-mcp"],
"env": {
"CHARACTER_FORGE_DIR": "/Users/you/character-forge",
"FAL_KEY": "..."
### Remove it
Claude Code: /plugin uninstall character-forge@character-forge, then /plugin marketplace remove character-forge
Codex: delete the server in Codex's settings, then npm uninstall -g @gdhub/character-forge-mcp
Other apps: delete the character-forge entry from their MCP settings
Your characters stay in their folder until you delete it yourself.
## Use
Restart the app and ask in the chat:
> Make me a random character for a noir film.
> A 60-year-old ex-boxer for a coffee ad, warm but stubborn.
> Here's my sketch: hero.png. She's a desert pilot who is afraid of the sea.
You get a full character card. Then ask for more, one step at a time: "Draw the concept" (it comes with a face-centred avatar for free), "Put her in her place", "Bring the picture to life", "Give her a voice", "Write her music". Not sure what's next? Ask "What's next?".
Experimental: characters meet. In Claude Code, type /meet with 2–5 saved characters and a situation, for example /meet marta-vell pike-ostrander — stuck in a lift at night, the light goes out. They meet as strangers and play the scene in turns. You get a script with each one's private thoughts under their lines, and how each one's feelings toward the others changed. Free: the chat plays the characters.
Free: characters, cards, translations, and ready-made prompts you can use in any image, video, voice or music generator.
Paid: pictures, video, voice and music, made with your own fal.ai key. A whole character costs about $1.50. Nothing paid happens until you ask for it.
Listed badge (optional)
Copy this line into the README if you want the listing mark. Optional, and it does not affect being listed.
[](https://anclum.com/en/s/gdhub-io-character-forge-mcp/)
- Source
- github · https://github.com/gdhub-io/character-forge-mcp
- Browse by field
- Open source
- Traction
- 1 ★
- added
- today
More entries
Filed under
Every tag opens the full list for that filter. Counts are the live catalogue figures.