Skip to main content
Glama

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

  • エクスポート / 差分: export_manuscript、diff_chapter(ドラフト vs .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

オプション — 例: MiniMaxのAnthropic互換API用の https://api.minimax.io/anthropic

STORYWRIGHT_ANTHROPIC_MODEL

モデルID(例: MiniMax使用時の MiniMax-M2.7)

STORYWRIGHT_PROJECTS_ROOT

親ディレクトリ。プロジェクトは {root}/book_projects/<slug>/ に配置されます

STORYWRIGHT_STATE_DIR

load_last_book_project 用の last_project.json(デフォルト ~/.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は公式の 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

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