Skip to main content
Glama

๐Ÿช„ 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 claude

Prerequisites

  • Node.js (v14 or higher)

  • NPM (v6 or higher)

Step-by-Step Installation

  1. Clone or download the repository

    git clone https://github.com/your-username/uno-mcp.git
    cd uno-mcp
  2. Install dependencies

    npm install
  3. Build the TypeScript files

    npm run build
  4. Make the server executable (skip on Windows)

    chmod +x dist/index.js
  5. Test the server

    node test-run.js

    This will run the server on a sample story and generate three files:

    • test-analysis.md: Sample analysis report

    • test-enhanced.txt: Sample enhanced text (200%)

    • test-custom-enhanced.txt: Sample custom enhancement (150%)

๐Ÿ”Œ MCP Integration

Claude Desktop Integration

  1. Edit Claude configuration file

    • Windows: C:\Users\[username]\AppData\Roaming\Claude\claude_desktop_config.json

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  2. 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.

  3. Restart Claude After saving the configuration, restart Claude to activate the UNO MCP server.

VS Code Integration

  1. Edit VS Code Claude extension configuration

    • Windows: c:\Users\[username]\AppData\Roaming\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json

    • macOS: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

  2. Add the same configuration as shown above for Claude Desktop.

  3. 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_text to understand what your text needs

  • ๐ŸŽฏ For subtle enhancements, use custom_enhance_text with 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: true only 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

Available Tools

3 tools
analyze_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

    C2.7/5.0

    Scored across 3 tools

    Disambiguation2/5

    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.

    Naming Consistency4/5

    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.

    Tool Count3/5

    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.

    Completeness2/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Enables 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.
      19
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      Combines structured sequential thinking with batch operation execution, enabling step-by-step reasoning with revision/branching capabilities and chained operations with variable piping between steps.
      15
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A 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
    • A
      license
      Not graded
      quality
      C
      maintenance
      Exposes 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