Storywright MCP

Cursor、Claude Desktop、OpenCode、またはstdio経由でMCPを話すあらゆるホスト向けの、マルチエージェント書籍執筆MCPサーバーです。ガード付きの章パイプライン（執筆者 → 編集者 → 設定可能な第三者パス → 承認）、ディスク上のJSON/Markdownプロジェクト、書籍バイブルの計画、継続性トラッキング、原稿検索、マーカーのスキャン、前章のコンテキスト予算管理、およびエクスポート/差分ヘルパーを組み合わせています。

ゴールデンパス（最初の1時間）

1. インストール（このリポジトリから）:

   cd C:\Apps\claude_plugins\storywright-mcp
   uv sync --extra dev

2. APIキーの設定（ユーザー環境変数またはMCPの env ブロック）:

   • ANTHROPIC_API_KEY および/または ANTHROPIC_AUTH_TOKEN — 執筆者/編集者/第三者パスに必要です（MiniMaxは通常、Bearer + ANTHROPIC_BASE_URL を使用します）。

3. CursorにMCPを登録 — mcp.json を作成または編集します:

   スコープ	パス (Windows)
   ユーザー (全ワークスペース)	%USERPROFILE%\.cursor\mcp.json
   このリポジトリのみ	<repo>\.cursor\mcp.json

   ファイルに他のサーバーが既に存在する場合は、storywright を既存の "mcpServers" オブジェクトにマージしてください。

   Anthropic APIキー（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を再起動）。Cursorがサーバーを起動するターミナルでは、uv が PATH に通っている必要があります。

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が解析されます。

• エクスポート / 差分: export_manuscript、diff_chapter（ドラフト vs .prev.md）。

• リソース: storywright://project/*、storywright://meta/version。

インストール

cd storywright-mcp
uv sync --extra dev

環境変数

MiniMax (Anthropic互換ゲートウェイ)

Storywrightは公式の anthropic Python SDK を使用しており、Claude Codeと同様に ANTHROPIC_BASE_URL と ANTHROPIC_AUTH_TOKEN を読み取ります。~/.claude/settings.json の env を、Cursor（またはシェル）の Storywright MCP env ブロック にミラーリングしてください。例:

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

• ANTHROPIC_AUTH_TOKEN = あなたのMiniMaxトークン (Bearer)

• STORYWRIGHT_ANTHROPIC_MODEL = MiniMax-M2.7 (またはプロバイダーが期待するモデルID)

APIキーをコミットしないでください。OS環境変数またはCursorシークレットを優先してください。

実行 (stdio)

uv run storywright-mcp
uv run python -m storywright_mcp

Claude Desktop / OpenCode

アプリがMCP stdioサーバーをサポートしている場合は、Cursorと同じ command / args を使用してください。

一般的なワークフロー

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はプッシュ/PR時に ruff + pytest を実行します (.github/workflows/ci.yml)。

ライセンス

MIT