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: creative-subagent-runner-mcp

Функции

• Строгий рабочий процесс: Третий проход только после редактора; утверждение требует всех настроенных агентов третьего прохода, если не установлено 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

Окружение

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