UNO-MCP
UNO-MCP (Unified Narrative Operator) is a narrative enhancement server that transforms story text through analysis and expansion techniques.
Analyze Text (
analyze_text): Performs deep analysis of story content, generating a report covering narrative position (beginning, middle, climax, resolution), character focus, scene type, mood/tone, repetition patterns, and enhancement recommendations.Enhance Text (
enhance_text): Automatically expands and improves text by applying all five enhancement techniques simultaneously, with a configurable expansion target (100%โ500%, default: 200%).Custom Enhance Text (
custom_enhance_text): Selectively apply specific techniques with a custom expansion target (100%โ500%):Golden Shadow Enhancement: Develops underdeveloped characters, unexplored plot elements, and subtext.
Environmental Expansion: Enriches settings with vivid sensory details and atmosphere.
Action Scene Enhancement: Intensifies action sequences with dynamic pacing and heightened sensory detail.
Prose Smoothing: Improves flow, transitions, and sentence rhythm.
Repetition Elimination: Reduces unintentional repetition while preserving the author's voice.
Use cases include creative writing assistance, novel expansion, game narrative development, and writing coaching.
Runs as a Node.js application, enabling server-side execution of the narrative enhancement tools.
Built with TypeScript, allowing for type-safe development and integration with the MCP server.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@UNO-MCP enhance this fantasy battle scene to make it more intense"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
๐ช UNO: Unified Narrative Operator
โจ Overview
UNO (Unified Narrative Operator) is a magical text enhancement tool that transforms ordinary story content into rich, detailed narratives. Using advanced literary techniques and heuristic analysis, UNO can double the length of your text while preserving the original voice and intent.
Think of UNO as your personal narrative assistant, capable of:
๐ Analyzing your text to understand its strengths and weaknesses
๐ฑ Growing underdeveloped story elements
๐จ Enriching environmental descriptions
โก Intensifying action sequences
๐ Smoothing prose flow and rhythm
๐ Eliminating repetitive language
Related MCP server: Galaxy Brain
๐ ๏ธ Features
UNO provides three powerful MCP tools:
1. ๐ analyze_text
Performs deep analysis of your story pages and generates a comprehensive report including:
๐ Narrative position assessment (beginning, middle, climax, resolution)
๐ค Character focus identification
๐ญ Scene type classification
๐ก๏ธ Mood and tone evaluation
๐ Enhancement recommendations for each technique
๐ Repetition pattern detection
2. โจ enhance_text
Transforms your text by applying all five enhancement techniques:
Automatically expands text to meet target length (default: 200%)
Intelligently applies techniques based on what your text needs most
Balances expansions across the entire text
3. โ๏ธ custom_enhance_text
Gives you complete control over the enhancement process:
Choose which enhancement techniques to apply
Set custom expansion targets (100%-500%)
Focus on specific aspects of your narrative
๐ Enhancement Techniques
1. ๐ป Golden Shadow Enhancement
Identifies underdeveloped elements in your story and expands them:
Develops mentioned but undeveloped characters
Explores implied but unexplained plot elements
Surfaces subtext and hidden meanings
2. ๐๏ธ Environmental Expansion
Enriches your settings with immersive details:
Adds vivid sensory experiences (visual, auditory, tactile, olfactory)
Creates memorable focus on insignificant objects
Deepens the atmosphere and mood
3. โก Action Scene Enhancement
Transforms action sequences into dynamic, high-intensity experiences:
Manipulates perceived time (slowing crucial moments)
Intensifies sensory details during action
Creates rhythmic alternation between explosive action and momentary stillness
Makes environments active participants in the action
4. ๐ Prose Smoothing
Improves the flow and rhythm of your writing:
Enhances transitions between paragraphs
Varies sentence structure for better readability
Creates a natural rhythm that pulls readers through the text
5. ๐ Repetition Elimination
Reduces unintentional repetition while preserving style:
Identifies and replaces repeated words with meaningful alternatives
Maintains the author's voice and intent
Distinguishes between intentional and unintentional repetition
๐ Installation
Installing via Smithery
To install Unified Narrative Operator for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @MushroomFleet/uno-mcp --client claudePrerequisites
Node.js (v14 or higher)
NPM (v6 or higher)
Step-by-Step Installation
Clone or download the repository
git clone https://github.com/your-username/uno-mcp.git cd uno-mcpInstall dependencies
npm installBuild the TypeScript files
npm run buildMake the server executable (skip on Windows)
chmod +x dist/index.jsTest the server
node test-run.jsThis will run the server on a sample story and generate three files:
test-analysis.md: Sample analysis reporttest-enhanced.txt: Sample enhanced text (200%)test-custom-enhanced.txt: Sample custom enhancement (150%)
๐ MCP Integration
Claude Desktop Integration
Edit Claude configuration file
Windows:
C:\Users\[username]\AppData\Roaming\Claude\claude_desktop_config.jsonmacOS:
~/Library/Application Support/Claude/claude_desktop_config.json
Add UNO to the MCP servers section
{ "mcpServers": { "uno": { "command": "node", "args": ["/absolute/path/to/uno-mcp/dist/index.js"], "disabled": false, "autoApprove": [] } } }Be sure to use the absolute path to your UNO installation.
Restart Claude After saving the configuration, restart Claude to activate the UNO MCP server.
VS Code Integration
Edit VS Code Claude extension configuration
Windows:
c:\Users\[username]\AppData\Roaming\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.jsonmacOS:
~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
Add the same configuration as shown above for Claude Desktop.
Restart VS Code or reload the window.
๐ Usage Examples
Analyzing a Story
<use_mcp_tool>
<server_name>uno</server_name>
<tool_name>analyze_text</tool_name>
<arguments>
{
"text": "As Sarah walked into the garden, she noticed the old statue in the corner. It was covered in moss and vines, almost hidden from view. She felt drawn to it somehow."
}
</arguments>
</use_mcp_tool>This will return a detailed analysis report with insights about the narrative position, character focus, enhancement opportunities, and more.
Enhancing a Story (200% Expansion)
<use_mcp_tool>
<server_name>uno</server_name>
<tool_name>enhance_text</tool_name>
<arguments>
{
"text": "As Sarah walked into the garden, she noticed the old statue in the corner. It was covered in moss and vines, almost hidden from view. She felt drawn to it somehow."
}
</arguments>
</use_mcp_tool>This will return a version of your text that's approximately double the original length, with all five enhancement techniques applied.
Custom Enhancement
<use_mcp_tool>
<server_name>uno</server_name>
<tool_name>custom_enhance_text</tool_name>
<arguments>
{
"text": "As Sarah walked into the garden, she noticed the old statue in the corner. It was covered in moss and vines, almost hidden from view. She felt drawn to it somehow.",
"expansionTarget": 150,
"enableGoldenShadow": true,
"enableEnvironmental": true,
"enableActionScene": false,
"enableProseSmoother": true,
"enableRepetitionElimination": false
}
</arguments>
</use_mcp_tool>This example applies only Golden Shadow Enhancement, Environmental Expansion, and Prose Smoothing, targeting a 150% expansion.
โก Integration Use Cases
๐ Creative Writing Assistant
Can you enhance this scene with more environmental details?
<use_mcp_tool>
<server_name>uno</server_name>
<tool_name>custom_enhance_text</tool_name>
<arguments>
{
"text": "Jack entered the abandoned warehouse, searching for clues.",
"expansionTarget": 300,
"enableEnvironmental": true,
"enableGoldenShadow": false,
"enableActionScene": false,
"enableProseSmoother": false,
"enableRepetitionElimination": false
}
</arguments>
</use_mcp_tool>๐ Writing Coach
Let me analyze this paragraph to give you feedback:
<use_mcp_tool>
<server_name>uno</server_name>
<tool_name>analyze_text</tool_name>
<arguments>
{
"text": "[student's writing sample]"
}
</arguments>
</use_mcp_tool>
Based on the analysis, I recommend focusing on developing your character motivations more clearly.๐ฎ Game Narrative Development
Here's a more intense version of your action scene:
<use_mcp_tool>
<server_name>uno</server_name>
<tool_name>custom_enhance_text</tool_name>
<arguments>
{
"text": "[original action scene]",
"enableActionScene": true,
"enableEnvironmental": true,
"enableGoldenShadow": false,
"enableProseSmoother": true,
"enableRepetitionElimination": true
}
</arguments>
</use_mcp_tool>๐ Novel Expansion
Let me help you expand this chapter:
<use_mcp_tool>
<server_name>uno</server_name>
<tool_name>enhance_text</tool_name>
<arguments>
{
"text": "[chapter excerpt]",
"expansionTarget": 180
}
</arguments>
</use_mcp_tool>๐ก Tips & Tricks
๐ Always start with
analyze_textto understand what your text needs๐ฏ For subtle enhancements, use
custom_enhance_textwith a lower expansion target (120-150%)๐งฉ Break longer texts into smaller sections for processing, then combine the results
๐ Apply Repetition Elimination as the final step when enhancing longer works
โก Use
enableActionScene: trueonly for scenes that contain action elements
๐ License
ISC
๐ Acknowledgements
UNO is based on advanced literary enhancement techniques and narrative theory. Special thanks to the storytellers, writers, and narrative theorists whose work inspired this project.
โญ Made with love by the UNO team โญ
See Also
TranscriptionTools-MCP โ Transcript processing
DeepLucid3D-MCP โ Cognitive processing
UNO-MCP โ Narrative enhancement
gitea-mcp โ Gitea integration
zero-vector-MCP โ Procedural generation
Available Tools
3 toolsanalyze_textC
Analyzes a story page and generates a report with insights
Inputs: text (required).
custom_enhance_textC
Enhances a story page using selected techniques
Inputs: text (required), expansionTarget, enableGoldenShadow, enableEnvironmental, +3 more.
enhance_textC
Enhances a story page using all techniques to meet expansion target
Inputs: text (required), expansionTarget.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogโฆ
TDQS
Scored across 3 tools
The tools 'custom_enhance_text' and 'enhance_text' have overlapping purposes, both focused on enhancing story pages, with only a vague distinction based on technique selection versus using all techniques. This creates ambiguity where an agent might struggle to choose between them for a given enhancement task. The 'analyze_text' tool is more distinct but the enhancement tools lack clear boundaries.
All tools follow a consistent snake_case naming pattern with a verb_noun structure (e.g., analyze_text, enhance_text). The naming is predictable and readable, with only minor deviation in 'custom_enhance_text' where the adjective 'custom' adds some variation but maintains the overall convention.
With only 3 tools, the server feels thin for a domain like story analysis and enhancement, potentially lacking coverage for broader operations. While it covers basic analyze and enhance functions, the low count may limit agent capabilities in handling more complex workflows or additional CRUD-like actions.
The tool set is severely incomplete for a story analysis and enhancement domain, as it only includes analysis and enhancement without any CRUD operations (e.g., create, update, delete story pages) or lifecycle management. This creates significant gaps that will likely cause agent failures when trying to perform full workflows beyond simple text processing.
Maintenance
Related MCP Connectors
LLM chat, text tools, image generation, editing, batch image jobs, and asynchronous video generation
Read, write, and expand ideas with other AI agents in a public commons. No account needed.
ERC-8004 agent identity, on-chain subscriptions, reputation, A2A tasks and chat over 53 tools.
Make videos and docs with your AI agent โ describe what you need, every output stays editable.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables AI-guided hierarchical fiction writing through structured XML documents. Supports step-by-step narrative expansion from book-level planning down to individual paragraphs, with custom Roo Code modes for collaborative story development.19MIT
- AlicenseBqualityDmaintenanceCombines structured sequential thinking with batch operation execution, enabling step-by-step reasoning with revision/branching capabilities and chained operations with variable piping between steps.151MIT
- AlicenseNot gradedqualityDmaintenanceA narrative graph engine that enables LLMs to generate, track, and mutate complex fictional worlds while maintaining consistency between factions, characters, and locations. It acts as a specialized RAG framework for storytelling, allowing models to manage thousands of entities without exceeding context limits.MIT
- AlicenseNot gradedqualityCmaintenanceExposes 30+ novel-writing tools over stdio or HTTP so external agents such as Claude Code or WorkBuddy can use their own models and API keys to read chapters, write prose, manage characters, foreshadowing, story arcs and worldbuilding, run local semantic search, and launch review sub-agents. Supports one-click enabling with configurable port, token, and approval mode.AGPL 3.0