UNO

Unified Narrative Operator

typescript

11

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "mushroomfleet-uno-mcp": {
      "command": "node",
      "args": [
        "/absolute/path/to/uno-mcp/dist/index.js"
      ]
    }
  }
}

UNO MCP Server provides a local MCP interface that exposes the Unified Narrative Operator tools to your client applications. It lets you analyze, enhance, and customize narrative text through a structured set of MCP tools, enabling you to automatically grow underdeveloped story elements, enrich settings, drive action, smooth prose, and remove repetition in a controlled way.

How to use

You use UNO by connecting your MCP client to the UNO MCP Server and invoking the available tools. Start with an analysis to understand your text, then apply enhancements to expand and refine your narrative. Use custom enhancement when you want precise control over which techniques to apply and how aggressively to expand your text.

How to install

Prerequisites you need before installing UNO MCP Server are Node.js version 14 or higher and npm version 6 or higher.

# 1) Clone the UNO MCP repository
git clone https://github.com/mushroomfleet/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

Additional notes

To integrate UNO with client environments like Claude or VS Code, add UNO as an MCP server in the respective configuration. The UNO server runs locally via a Node command that executes the built index file.

Available tools

analyze_text

Performs deep analysis of your story pages and generates a comprehensive report, including narrative position, character focus, scene type, mood, enhancement recommendations, and repetition patterns.

enhance_text

Transforms your text by applying all five enhancement techniques, expanding content toward a target length and balancing improvements across the narrative.

custom_enhance_text

Gives you granular control over the enhancement process, allowing you to choose techniques, set custom expansion targets, and focus on specific narrative aspects.