Skip to main content
Glama

Storywright MCP

Многоагентный MCP-сервер для написания книг для Cursor, Claude Desktop, OpenCode или любого хоста, поддерживающего MCP через stdio. Он объединяет защищенный конвейер обработки глав (писатель → редактор → настраиваемые третьи проходы → утверждение), работу с JSON/Markdown проектами на диске, планирование «библии» книги, отслеживание непрерывности, поиск по рукописи, сканирование маркеров, бюджетирование контекста предыдущих глав и вспомогательные инструменты для экспорта/сравнения.

Золотой путь (первый час)

  1. Установка (из этого репозитория):

    cd C:\Apps\claude_plugins\storywright-mcp
    uv sync --extra dev
  2. Установка API-ключа (пользовательские переменные окружения или блок env в MCP):

    • ANTHROPIC_API_KEY и/или ANTHROPIC_AUTH_TOKEN — требуется для писателя/редактора/третьего прохода (MiniMax обычно использует Bearer + ANTHROPIC_BASE_URL).

  3. Регистрация MCP в Cursor — создайте или отредактируйте mcp.json:

    Область действия

    Путь (Windows)

    Пользователь (все рабочие области)

    %USERPROFILE%\.cursor\mcp.json

    Только этот репозиторий

    <repo>\.cursor\mcp.json

    Объедините storywright с существующим объектом "mcpServers", если в файле уже есть другие серверы.

    API-ключ Anthropic (секреты через переменные окружения Windows — установите пользовательские переменные, затем сошлитесь на них):

    {
      "mcpServers": {
        "storywright": {
          "command": "uv",
          "args": ["run", "--directory", "C:/Apps/claude_plugins/storywright-mcp", "storywright-mcp"],
          "env": {
            "ANTHROPIC_API_KEY": "${env:ANTHROPIC_API_KEY}",
            "STORYWRIGHT_PROJECTS_ROOT": "C:/Users/you/Documents/writing",
            "STORYWRIGHT_ANTHROPIC_MODEL": "claude-sonnet-4-20250514"
          }
        }
      }
    }

    MiniMax (так же, как в вашей рабочей оболочке — Bearer + базовый URL + модель):

    {
      "mcpServers": {
        "storywright": {
          "command": "uv",
          "args": ["run", "--directory", "C:/Apps/claude_plugins/storywright-mcp", "storywright-mcp"],
          "env": {
            "ANTHROPIC_BASE_URL": "https://api.minimax.io/anthropic",
            "ANTHROPIC_AUTH_TOKEN": "${env:ANTHROPIC_AUTH_TOKEN}",
            "STORYWRIGHT_ANTHROPIC_MODEL": "MiniMax-M2.7",
            "STORYWRIGHT_PROJECTS_ROOT": "C:/Users/you/Documents/writing"
          }
        }
      }
    }

    Установите ANTHROPIC_AUTH_TOKEN в переменных среды Windows (пользовательские) или временно встройте значение, только если принимаете риск его хранения на диске. Отредактируйте STORYWRIGHT_PROJECTS_ROOT, указав путь, где должны храниться book_projects/.

    Перезагрузка MCP: Палитра команд → “Cursor: Reload MCP Servers” (или перезапустите Cursor). uv должен быть в PATH терминала, из которого Cursor запускает серверы.

  4. В чате запускайте инструменты по порядку:

    • check_environment — подтверждает ключ + модель + версию.

    • `create_book_project(project_name="my-novel", book_title="My Novel", third_agents=["comedy","pacing"])

    • plan_book() … через фазы (необязательно) или пропустите к главам.

    • add_chapter / add_character по мере необходимости.

    • get_pipeline_status — показывает точный следующий инструмент для каждой главы.

    • Для каждой главы: start_chapter → run_writer_agent → run_editor_review → каждый run_third_agent → approve_chapter.

  5. Артефакты, которые нужно знать:

    • briefs/revision_queue.json — заметки из request_revision (промпт писателя считывает их).

    • reports/chapter-NN-editor-meta.json — разобранный вердикт + мета-блок от редактора.

    • manuscript/chapter-NN-draft.prev.md — резервная копия перед каждой перезаписью писателем; используйте diff_chapter.

    • EXPORT-manuscript.md — опциональный вывод из export_manuscript.

Related MCP server: Nyxdoc

Функции

  • Строгий рабочий процесс: Третий проход только после редактора; утверждение требует всех настроенных агентов третьего прохода, если не установлено force=true.

  • Подсказки конвейера: get_pipeline_status перечисляет следующий вызов инструмента для каждой главы.

  • Готовность API: check_environment проверяет учетные данные Anthropic (ANTHROPIC_API_KEY и/или ANTHROPIC_AUTH_TOKEN) перед тем, как вы потратите сессию.

  • Бюджет предыдущей прозы: Писатель включает текст недавних утвержденных глав до настраиваемых лимитов слов/глав (экономит контекст по сравнению с загрузкой всей книги целиком).

  • Повторные попытки: Переходные ошибки Anthropic (429/5xx, тайм-ауты) повторяются с экспоненциальной задержкой (STORYWRIGHT_ANTHROPIC_MAX_RETRIES).

  • Структурированные метаданные редактора: Отчеты редактора должны заканчиваться ---STORYWRIGHT_META_START--- … END---; разобранный JSON находится рядом с отчетом в формате markdown.

  • Экспорт / сравнение: export_manuscript, diff_chapter (черновик против .prev.md).

  • Ресурсы: storywright://project/*, storywright://meta/version.

Установка

cd storywright-mcp
uv sync --extra dev

Окружение

Переменная

Назначение

ANTHROPIC_API_KEY

Опционально, если используется Bearer ниже — вызовы писателя/редактора/третьего прохода

ANTHROPIC_AUTH_TOKEN

Опционально — токен Bearer (тот же шаблон, что и в Claude Code; MiniMax часто использует его вместо API_KEY)

ANTHROPIC_BASE_URL

Опционально — например, https://api.minimax.io/anthropic для API MiniMax, совместимого с Anthropic

STORYWRIGHT_ANTHROPIC_MODEL

ID модели (например, MiniMax-M2.7 при использовании MiniMax)

STORYWRIGHT_PROJECTS_ROOT

Родительская директория; проекты попадают в {root}/book_projects/<slug>/

STORYWRIGHT_STATE_DIR

last_project.json для load_last_book_project (по умолчанию ~/.storywright)

STORYWRIGHT_PRIOR_CHAPTERS_MAX_WORDS

Макс. количество слов предыдущей утвержденной прозы, внедряемой писателю (по умолчанию ~12000)

STORYWRIGHT_PRIOR_CHAPTERS_MAX_COUNT

Макс. количество учитываемых предыдущих глав (по умолчанию ~8)

STORYWRIGHT_ANTHROPIC_MAX_RETRIES

Повторные попытки при временных сбоях API (по умолчанию ~2)

STORYWRIGHT_ANTHROPIC_RETRY_DELAY_SECONDS

Базовая задержка между повторными попытками (по умолчанию ~2.0)

MiniMax (шлюз, совместимый с Anthropic)

Storywright использует официальный Python SDK anthropic, который считывает ANTHROPIC_BASE_URL и ANTHROPIC_AUTH_TOKEN так же, как Claude Code. Скопируйте env из вашего ~/.claude/settings.json в блок env Storywright MCP в Cursor (или оболочке), например:

  • ANTHROPIC_BASE_URL = https://api.minimax.io/anthropic

  • ANTHROPIC_AUTH_TOKEN = ваш токен MiniMax (Bearer)

  • STORYWRIGHT_ANTHROPIC_MODEL = MiniMax-M2.7 (или любой другой ID модели, который ожидает ваш провайдер)

Не коммитьте API-ключи; предпочитайте переменные окружения ОС или секреты Cursor.

Запуск (stdio)

uv run storywright-mcp
uv run python -m storywright_mcp

Claude Desktop / OpenCode

Используйте те же command / args, что и в Cursor, если ваше приложение поддерживает MCP-серверы stdio.

Типичный рабочий процесс

  1. create_book_project(..., third_agents=[...]) или load_book_project("C:/absolute/.../book_projects/my-book")

  2. plan_book() … (опционально)

  3. start_chapter(1) → run_writer_agent(1) → run_editor_review(1) → run_third_agent(1, …) → approve_chapter(1)

Используйте get_pipeline_status всякий раз, когда теряете нить событий.

CLI

uv run storywright-mcp agents           # list third-pass agents
uv run storywright-mcp smoke             # ping Anthropic/MiniMax (tiny token use)
uv run storywright-mcp smoke --with-book # temp folder + new project + chapter 1 writer (full pipeline chunk)

Имена вроде run_editor_review(1) — это инструменты MCP (используются из Cursor/чата), а не команды оболочки. Из PowerShell вы можете вызвать ту же логику после load_book_project:

uv run python -c "from storywright_mcp import workflow; workflow.load_book_project(r'C:/path/to/book_projects/your-book'); print(workflow.run_editor_review(1))"

Тестирование MiniMax (или любого прокси, совместимого с Anthropic)

Из PowerShell установите те же переменные, что и в ~/.claude/settings.json, затем запустите smoke из репозитория (учетные данные остаются только в вашей оболочке):

$env:ANTHROPIC_BASE_URL = "https://api.minimax.io/anthropic"
$env:ANTHROPIC_AUTH_TOKEN = "<your-token>"
$env:STORYWRIGHT_ANTHROPIC_MODEL = "MiniMax-M2.7"
cd C:\Apps\claude_plugins\storywright-mcp
uv run storywright-mcp smoke

Если вы видите STORYWRIGHT_SMOKE_OK в выводе, значит маршрутизация и аутентификация работают. Используйте smoke --with-book, чтобы подтвердить работу create_book_project → run_writer_agent с реальным выводом (расходует больше токенов; файлы попадают во временную директорию storywright-smoke-*).

CI

GitHub Actions запускает ruff + pytest при push/PR (.github/workflows/ci.yml).

Лицензия

MIT

Available Tools

35 tools
add_chapterC

Register a chapter outline.

Inputs: chapter_num (required), title (required), target_words. Returns: result

add_characterC

Add a character and continuity entry.

Inputs: name (required), role (required), description, voice_notes, +1 more. Returns: result

add_deathC

Schedule a canonical death.

Inputs: character (required), chapter (required), circumstances (required), death_style. Returns: result

add_established_factD

Inputs: fact (required), chapter (required), source. Returns: result

add_inventory_itemD

Track an inventory item.

Inputs: name (required), initial_holder (required), description, acquired_chapter. Returns: result

add_locationD

Inputs: chapter (required), location (required), description. Returns: result

add_running_gagD

Register a running gag.

Inputs: name (required), owner (required), setup_chapter (required), description, +1 more. Returns: result

approve_chapterA

Approve chapter; updates continuity. Requires all configured third passes unless force=true.

Inputs: chapter_num (required), force. Returns: result

check_environmentA

Verify ANTHROPIC_API_KEY and show model / prior-chapter budget / Storywright version.

Inputs: no named parameters. Returns: result

create_book_projectC

Create a new book project under book_projects/ (or STORYWRIGHT_PROJECTS_ROOT). Loads the new project.

Inputs: project_name (required), book_title (required), genre, authors, +2 more. Returns: result

diff_chapterC

Diff current draft vs .prev.md snapshot from last writer overwrite.

Inputs: chapter_num (required), max_lines. Returns: result

export_manuscriptC

Concatenate approved chapters into one markdown file at project root.

Inputs: output_filename. Returns: result

fire_gagD

Inputs: gag_name (required), chapter (required). Returns: result

get_book_bibleD

Readable bible markdown.

Inputs: no named parameters. Returns: result

get_chapter_statusC

Inspect one chapter.

Inputs: chapter_num (required). Returns: result

get_continuity_logC

JSON continuity log.

Inputs: no named parameters. Returns: result

get_inventoryD

Inputs: no named parameters. Returns: result

get_living_charactersD

Inputs: no named parameters. Returns: result

get_pipeline_statusB

Next MCP tool to call per chapter (guarded pipeline hints).

Inputs: no named parameters. Returns: result

get_project_statusB

Markdown table of chapters, statuses, editor verdicts, third-pass completion.

Inputs: no named parameters. Returns: result

get_running_gagsD

Inputs: no named parameters. Returns: result

list_third_agentsA

List built-in third-pass agents.

Inputs: no named parameters. Returns: result

load_book_projectB

Load an existing project from disk (prefer absolute paths).

Inputs: project_path (required). Returns: result

load_last_book_projectA

Load the last successfully opened project from ~/.storywright/last_project.json if valid.

Inputs: no named parameters. Returns: result

mark_character_deadD

Inputs: character_name (required), chapter (required), cause (required). Returns: result

plan_bookC

Phased book bible planning (identity→…→tone); completes with sync to project config.

Inputs: phase, data, reset, status. Returns: result

request_revisionC

Send chapter back to writer with notes.

Inputs: chapter_num (required), notes (required). Returns: result

run_editor_reviewC

Editor pass after writer.

Inputs: chapter_num (required). Returns: result

run_third_agentB

Third-pass reviewer (comedy, pacing, …). Repeat until all project.third_agents covered.

Inputs: chapter_num (required), agent_type. Returns: result

run_writer_agentA

Draft chapter via Claude (DRAW → AWAITING_EDITOR). Requires ANTHROPIC_API_KEY.

Inputs: chapter_num (required), chapter_brief. Returns: result

scan_manuscript_markersA

Find TODO/FIXME/DRAFT/TBD/XXX markers in manuscript markdown.

Inputs: no named parameters. Returns: result

search_manuscriptC

Substring search across manuscript/*.md.

Inputs: query (required), file_glob. Returns: result

start_chapterB

Open drafting for a chapter (NOT_STARTED → DRAFT).

Inputs: chapter_num (required). Returns: result

transfer_itemD

Inputs: item_name (required), new_holder (required), chapter (required). Returns: result

update_planC

Patch book_bible.json; may sync characters/deaths/gags into project.

Inputs: section, changes. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2/5.0

    Scored across 35 tools

    Disambiguation2/5

    Many tool descriptions are blank or minimal (e.g., add_location, fire_gag, get_inventory), and several tools have overlapping purposes (e.g., add_death vs mark_character_dead, add_running_gag vs fire_gag). This makes it difficult for an agent to distinguish between tools.

    Naming Consistency3/5

    Tool names follow a verb_noun pattern but use a wide variety of verbs (add, approve, check, create, diff, export, fire, get, list, load, mark, plan, request, run, scan, search, start, transfer, update). This variety, while not chaotic, lacks a strong consistent theme.

    Tool Count2/5

    35 tools is far above the recommended range of 3-15 for a well-scoped set, and significantly exceeds the 25+ threshold. The high count suggests over-specialization or redundant functionality.

    Completeness3/5

    The tool set covers many aspects of story writing (chapters, characters, inventory, gags, planning, etc.) but lacks basic CRUD operations such as delete or update for most resources, and has redundant tools (e.g., add_death and mark_character_dead). Some obvious gaps in lifecycle management are present.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      A local MCP server for maintaining internal consistency in fiction writing, with constraint-based fact checking, branching, and author-oracle conflict resolution.
      27
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      MCP server for Nyxdoc, a document system where humans and external agents collaborate on documents with version history, agent to-dos, and workspace permissions.
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      An MCP server that lets multiple AI coding agents share state, preserve context across sessions, and coordinate via a knowledge graph, messaging, and branch-preserving checkpoint/resume with conflict handling.
      76 npm
      1
      Apache 2.0