Storywright MCP
Storywright MCP
Многоагентный MCP-сервер для написания книг для Cursor, Claude Desktop, OpenCode или любого хоста, поддерживающего MCP через stdio. Он объединяет защищенный конвейер обработки глав (писатель → редактор → настраиваемые третьи проходы → утверждение), работу с JSON/Markdown проектами на диске, планирование «библии» книги, отслеживание непрерывности, поиск по рукописи, сканирование маркеров, бюджетирование контекста предыдущих глав и вспомогательные инструменты для экспорта/сравнения.
Золотой путь (первый час)
Установка (из этого репозитория):
cd C:\Apps\claude_plugins\storywright-mcp uv sync --extra devУстановка API-ключа (пользовательские переменные окружения или блок
envв MCP):ANTHROPIC_API_KEYи/илиANTHROPIC_AUTH_TOKEN— требуется для писателя/редактора/третьего прохода (MiniMax обычно использует Bearer +ANTHROPIC_BASE_URL).
Регистрация 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 запускает серверы.В чате запускайте инструменты по порядку:
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.
Артефакты, которые нужно знать:
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Окружение
Переменная | Назначение |
| Опционально, если используется Bearer ниже — вызовы писателя/редактора/третьего прохода |
| Опционально — токен Bearer (тот же шаблон, что и в Claude Code; MiniMax часто использует его вместо |
| Опционально — например, |
| ID модели (например, |
| Родительская директория; проекты попадают в |
|
|
| Макс. количество слов предыдущей утвержденной прозы, внедряемой писателю (по умолчанию ~12000) |
| Макс. количество учитываемых предыдущих глав (по умолчанию ~8) |
| Повторные попытки при временных сбоях API (по умолчанию ~2) |
| Базовая задержка между повторными попытками (по умолчанию ~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/anthropicANTHROPIC_AUTH_TOKEN= ваш токен MiniMax (Bearer)STORYWRIGHT_ANTHROPIC_MODEL=MiniMax-M2.7(или любой другой ID модели, который ожидает ваш провайдер)
Не коммитьте API-ключи; предпочитайте переменные окружения ОС или секреты Cursor.
Запуск (stdio)
uv run storywright-mcp
uv run python -m storywright_mcpClaude Desktop / OpenCode
Используйте те же command / args, что и в Cursor, если ваше приложение поддерживает MCP-серверы stdio.
Типичный рабочий процесс
create_book_project(..., third_agents=[...])илиload_book_project("C:/absolute/.../book_projects/my-book")plan_book()… (опционально)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 toolsadd_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
Scored across 35 tools
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.
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.
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.
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
Related MCP Connectors
Agentic AI book creator: plan, write, illustrate, narrate, and publish books from any MCP client.
Project management shared by people and AI agents, with persistent project state through MCP.
Publish Git-backed multilingual novels with agents, safe layouts, reviews, and author approval.
MCP Server for Slima - AI Writing IDE for Novel Authors with AI Beta Reader.
Related MCP Servers
- AlicenseAqualityDmaintenanceA local MCP server for maintaining internal consistency in fiction writing, with constraint-based fact checking, branching, and author-oracle conflict resolution.27MIT
- AlicenseNot gradedqualityBmaintenanceMCP server for Nyxdoc, a document system where humans and external agents collaborate on documents with version history, agent to-dos, and workspace permissions.MIT
- FlicenseNot gradedqualityDmaintenanceMCP server enabling AI agents to collaborate in shared rooms with a document edited via compare-and-swap optimistic concurrency, plus a chat channel and change deltas.-
- AlicenseNot gradedqualityBmaintenanceAn 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 npm1Apache 2.0