KitchenSink4Word

KitchenSink4Word

AI アシスタントで Word 文書を編集できます。変更履歴、引用、テンプレート、開いている文書へのライブ編集に対応しています。

AI は Word で 231 種類の操作を実行できます。変更のたびにバックアップを作成し、依頼の対象が複数の場所になり得る場合は推測せずに質問します。

KitchenSink4Word は、Claude Code、Codex CLI、Copilot CLI、Claude Desktop、その他のローカル MCP クライアントで .docx ファイルを読み取り、編集できる MCP サーバーです。Microsoft Word で開いている文書を編集することもできるため、変更が反映される様子を確認できます。これは AGPL-3.0 でライセンスされた無料の Community エディションです。

製品ページ · llms.txt · 変更履歴

プラットフォーム： Windows。.docx ファイルの編集には Word のインストールは不要です。ライブ編集と、Word を利用する機能（PDF のインポートとエクスポート、文書の比較、校正、フィールドの更新）には Microsoft Word が必要です。

インストール

このパッケージには Python 3.12 以降が必要です。以下のコマンドは、AI チャットではなく、PowerShell またはターミナルで実行してください。

Claude Code または Codex CLI。 uv をインストールし、使用するアプリの行を実行して、新しいセッションを開始してください。

claude mcp add word -s user -- uvx kitchensink4word

codex mcp add word -- uvx kitchensink4word

Claude Desktop。 uv をインストールして、Claude Desktop を再起動してください。最新リリースから .mcpb ファイルをダウンロードし、設定 > 拡張機能 > 詳細設定 > 拡張機能をインストールを開いて、ファイルを選択してください。初回起動時に Python パッケージをダウンロードするため、ネットワーク接続が必要です。

その他のローカル MCP クライアント。 uvx をコマンドに、kitchensink4word を引数に指定するか、パッケージをインストールして kitchensink4word をサーバーコマンドとして実行してください。

pip install kitchensink4word

パッケージをインストールしただけでは AI アプリに接続されません。クライアントの設定で、ローカル MCP サーバーとして追加してください。

できること

• Word で開いたままのレポートを改訂でき、各編集が反映される様子を確認できます。
• 変更履歴の読み取り、承認、却下、変更履歴としての編集記録に加え、レビュアーのコメントにも対応できます。
• テンプレートへの入力、章ファイルの結合、差し込み印刷ができます。
• 表、リスト、見出し、セクション、ページレイアウトを作成し、書式を設定できます。
• Zotero ライブラリの引用を含め、引用文献、参考文献一覧、脚注、文末脚注、キャプション、相互参照を挿入できます。
• ファイルを渡す前に、書式、アクセシビリティ、文書構造を確認できます。
• 2 つの文書のバージョンを比較し、選択したテキストを墨消しし、Word を通じて PDF をインポートまたはエクスポートできます。

サーバーは、10 個のツールで計 115 個の操作を提供します。操作ごとに実行できる各アクション（たとえば、注釈や表の変更の種類ごと）を数えると、合計 231 個です。起動時にツール一覧全体が AI の作業メモリに使用するトークン数は約 9.2k です。数値は scripts/measure_surface.py と scripts/count_operations.py から取得しています。

主な特徴

• 結合セルをまたぐ列操作。 テーブルに横方向または縦方向の結合セルがあっても、列の挿入や削除が正しく機能します。
• 1回の呼び出しで一括編集。 20個のセル編集を20回の往復処理ではなく、1回のset_cells呼び出しで実行します。
• 実際の変更履歴。 編集ツールはtrackとauthorを受け取り、受信者が承諾または拒否できるWordの変更履歴を作成します。作成者を指定しない場合、変更とコメントにはOfficeのユーザー名（ご自身のWordで使われている名前）が署名され、結果のauthor_sourceに名前の取得元が示されます。1回の呼び出しをアシスタント名義にするには、author="assistant"を渡します。この場合、「AI Assistant via KS4Word」の署名が付きます。
• Wordネイティブの比較。 action="compare"を指定したcom_multi_documentは、2つのバージョンの変更履歴を生成します。
• ファイルを破損させない設計。 保存はアトミックに実行され、検証されます。変更のたびに以前のバージョンがバックアップされ、呼び出しで触れない要素（数式、テキストボックス、コンテンツコントロール）はバイト単位でそのまま保持されます。Wordで開いているファイルは、処理が停止する代わりに、明確なメッセージを表示して拒否されます。
• 分割されたランをまたぐ検索と置換。 Wordがテキストを多数のランに分割していても一致箇所を検出でき、文字ごとの書式も保持されます。ユーザーの正規表現にはタイムアウトが設定されています。
• 狙いどおりの編集。 テキストが複数箇所に一致する場合は候補をすべて示して拒否されるため、誤った段落が気付かれないまま編集されることはありません。また、拒否時には次に実行すべき呼び出しが示されます。

10 個のツールとコンテキストコスト

サーバーは最初のメッセージから 10 個のツールをすべて一覧表示するため、有効化が必要なものはありません。word_help 以外の各ツールは、実行する操作である op と、その引数（.docx の file_path を含む）である args を受け取ります。word_help は、任意の操作の引数と実行例を返します。操作で定義されていない引数は無視されず、拒否されます。トークン数は、クライアントが受け取る tools/list エントリー全体を数えたもので、scripts/measure_surface.py によるものです。

ツール	操作数	概算トークン数	対応内容
word_read	24	1,400	テキスト、アンカー付きドキュメントビュー、アウトライン、表の読み取り、テキストの検索、要素の一覧表示、スタイル、コメント、変更履歴、ヘッダーとフッター、プロパティ、保護の読み取り、検証と診断、単語数と構造化差分、引用チェック、get_workflows、get_server_info、Word のステータス
word_edit	9	1,103	段落の挿入、変更、削除、分割されたランにまたがる検索と置換、apply_edits による一括編集、区切り、アンカー、検証済みの墨消し
word_format	6	620	スタイル、文字書式と段落書式、見出しレベル、出版形式
word_structure	15	1,025	ヘッダーとフッター、セクション、ページ番号、リストと番号付け、表（作成、編集、再構成、並べ替え、インポート）、章のヘッダー、セクションの移動
word_media	12	906	画像、グラフ、数式、テキストボックス、ハイパーリンク、フィールド、コンテンツコントロール、フォームフィールド
word_review	7	787	スレッド形式のコメント、変更履歴の承認と却下、閉じたファイルでの変更履歴のオン／オフ、変更履歴をオフにして行った編集を以前のコピーと照合して記録、査読用の匿名化と復元、投稿の準備
word_references	13	1,032	脚注と文末脚注、キャプション、目次と図表目次、索引項目、ブックマーク、相互参照、Word 標準の引用と参考文献、Zotero での検索と引用、引用スタイルの変換
word_document	15	1,030	新規ドキュメントとコピーしたドキュメント、バックアップ、プロパティと埋め込みフォント、ドキュメントの挿入と分割、テンプレートと差し込み印刷、前付け、保護、透かし、アクセシビリティの修正、表のエクスポート
word_app	14	1,070	ローカルの Word を操作します。Word で開いているドキュメントの保存、ライブ編集、変更履歴の切り替え、フィールドの更新、PDF のインポートとエクスポート、比較と結合、校正、読みやすさの評価、開いた状態でのクリーン検証に対応します。Windows と Word が必要です。また、リクエストに応じてサーバーを更新（update_now）し、更新通知をオンまたはオフ（update_notices）にします
word_help	0	213	任意の操作の引数と実行例、および location オブジェクトの説明
10 個すべて	115	9,186	最初に一度読み込まれます。後から有効化が必要なものはありません

手順を知りたい場合は、AI に get_workflows を呼び出すよう依頼してください。各ステップに適したツールと操作を含む 13 個のタスクが一覧表示されます。Claude Code のように初回使用時にツールスキーマを読み込むクライアントでは、ツールを呼び出すまでコストはほとんどかかりません。サーバー独自の指示により、上記の数値に約 500 トークンが加わります。

より範囲を絞ったサーバーを利用したい管理者は、KS4W_READ_ONLY=1 を設定すると、読み取り操作だけが一覧表示されます。または、KS4W_FORBID に削除するツールや操作を指定してください（「Configuration」を参照）。削除されたものはコストに含まれなくなります。

権限確認のプロンプトを減らす： Claude Desktop で、このサーバーのツール権限のうち読み取り専用ツールを「常に許可」に設定してください。これらのツールで変更が加えられることはありません。編集ツールは「確認」のままにしてください。

安全モデル

• 閉じたファイルを変更する前に、毎回、現在のバージョンがドキュメントと同じ場所にある非表示の .ks4w-backups/ フォルダーにコピーされます。各ドキュメントには 2 つのコピーが保持されます。prev.docx は直近の変更前の状態、anchor.docx はセッション開始時の状態で、1 時間操作がないと更新されます。編集回数にかかわらず、ストレージの使用量はドキュメントあたり約 2 コピー分に保たれます。manage_backups ではバックアップの一覧表示、復元、削除ができ、復元自体も元に戻せます。
• Word で開いているドキュメントへの編集は、このバックアップシステムの対象外です。開いているドキュメントは、Word 独自の自動回復機能と元に戻す機能で保護されます。
• 保存はアトミックに実行され、検証されます。操作に失敗した場合、元のファイルは完全に元の状態のままです。
• 同じファイルへの変更は、同一サーバー内およびサーバープロセス間で直列化されるため、並列呼び出しによって互いの変更が上書きされることはありません。
• 脚注参照を含むコンテンツを削除すると、孤立した脚注も削除されます。また、validate は両方向の整合性を確認します。段落の削除では、目次などのフィールドを途中で切断したり、誤ってセクション区切りを削除したりする範囲は拒否されます。
• .ks4w-backups/ は、クラウド同期（OneDrive、Dropbox、Google Drive）の対象から除外してください。バックアップファイルは編集のたびに変更され、同期クライアントがロックを保持すると、保存が遅くなることがあります。
• 保護設定は尊重されます。 編集制限のあるドキュメントや、Windows の読み取り専用属性が設定されたファイルに対して、制限を回避して編集することはありません。書き込みは PROTECTED を返して拒否され、ファイルは完全に元の状態のままです。保護されたドキュメントでも set_document_protection と manage_backups は引き続き利用できるため、制限を解除したり、バックアップを復元したりできます。
• 破壊的な操作の前にスナップショットを作成します。 redact_text、resolve_revisions、prepare_for_submission、anonymize_for_review、set_document_protection は、操作前のファイルの状態をラベル付きで保存し、manage_backups でラベルを指定して復元できます。
• 推測せずに操作を拒否します。 対象が曖昧な場合はすべての候補を示して拒否します。不明なスタイル、キー、セルアドレスは名前を示して拒否します。また、ヘッダーの画像や表を削除する操作は、明示的な指示がない限り拒否します。拒否の応答は構造化され（{ok: false, error: {code, message, hint}}）、次に実行すべき呼び出しを示します。
• Word の操作はユーザーが管理します。 暗号化されたファイルは、サーバーの非表示の Word が起動する前に拒否されるため、デスクトップにパスワードダイアログが表示されることはありません。サーバーが Word プロセスを終了するのは、そのプロセスを自ら起動し、それを証明できる場合に限られます。プロセス名だけで終了することはありません。呼び出しが制限時間を超えると TIMEOUT が返され、ファイル編集の場合は何も保存されません。
• 墨消しと匿名化は保証されません。 redact_text は、安全に処理できるすべての箇所から指定されたテキストを削除し、保存後のファイルを再読み込みして、残っているものがあれば報告します。anonymize_for_review は、自己引用と著者メタデータをマスキングし、残りは確認できるようにフラグを付けます。どちらも画像やスキャン内のテキストは確認できず、イニシャルやニックネームなど、指定されていない名前を特定することもできません。共有または提出する前に、機密情報が含まれていないかご自身で確認してください。法的要件や規制に基づく墨消しには、専用ツールを使って最終 PDF に墨消しを施してください。

プライバシー

サーバーはお使いのコンピューター上で動作します。KitchenSink4AI がファイルや使用状況データを受け取ることはありません。AI アプリは、その設定と利用規約に従って、プロンプト、ファイルの内容、ツールの結果を独自のプロバイダーに送信する場合があります。以下で説明する更新チェックは、最大で週に 1 回 PyPI に接続し、パッケージ名とインストール済みバージョンのみを送信します。「今すぐ更新」を選ぶと、新しいバージョンが PyPI からダウンロードされます。Claude Desktop の場合は、新しいバンドルが GitHub からダウンロードされます。サーバーの起動バナーは無効になっているため、サーバーが実行するフレームワークによる独自のバージョンチェックは行われません。プライバシーポリシーでは、製品、購入、サポートについて説明しています。

設定

起動設定は、サーバーの構成に指定する環境変数です。起動時に一度だけ読み込まれ、その後変更されることはありません。また、ツール呼び出し、引数、プロンプトによって変更することもできません。サーバーが解析できない設定がある場合、起動は停止し、「The server did not start.」で終わる読みやすいメッセージが1行表示されます。

変数	効果
KS4W_READ_ONLY	読み取りを行う操作のみが表示され、ファイルを変更できなくなります
KS4W_FORBID	ツール名または操作名をカンマ区切りで指定すると、ツール一覧と word_help から除外されます。該当するものを呼び出すと NOT_AVAILABLE が返されます。不明な名前を指定すると起動が停止します。ここに word_app を指定すると、実行中の Word へのすべての経路（ほかの操作のライブ経路を含む）が閉じられます
KS4W_ALLOWED_ROOTS	パスのサンドボックスです。Windows では ;、それ以外では : でフォルダーを区切ります
KS4W_AUTHOR	呼び出しで作成者が指定されていない場合に、変更履歴とコメントに署名する名前です。user（デフォルト）では、ご自身の Office ユーザー名（Word が使用する名前）で署名します（メールアドレスは使われません。Windows のサインイン名がその代わりになります）。assistant では「AI Assistant via KS4Word」と署名します。また、設定にかかわらず、呼び出しで author="assistant" を指定すると、その名前で署名できます。呼び出しでそれ以外の author を指定した場合はその名前が優先されますが、メールアドレスは文書に書き込まれません。その場合はデフォルトの名前で署名され、その旨が応答に記載されます。Word で開いている文書では、Word が編集に自身のユーザー名で署名します
KS4W_CALL_TIMEOUT_S	1回の呼び出しに設定される実時間の上限（秒）。デフォルトは300、範囲は1～3600です
KS4W_MAX_CALL_TIMEOUT_S	Word によって実行される操作など、独自により長い上限を定める操作の上限です。デフォルトは900、範囲は1～3600です
KS4W_MAX_OUTPUT_CHARS	1回の応答の文字数上限です。デフォルトは80,000、最小値は2,000です。上限を超える応答は途中で切り詰められ、切り詰めた内容と続きを取得する方法が示されます
KS4W_UPDATE_CHECK	off にすると、更新チェックが完全に無効になります（旧設定の KS4W_NO_UPDATE_CHECK=1 も使用できます）
KS4W_UPDATE_NOTICES	off にすると更新通知が無効になり、無効にした後で on にすると再び有効になります

以前のバージョンの設定も処理されます。古いデフォルト設定（KS4W_MODE=lite、full、everything、KS4W_PACK_POLICY=auto、KS4W_ALL_TOOLS、KS4W_LOCK_TOOLS の無効化）は無視され、その旨が stderr に1行で通知され、ステータスレポートにも表示されます。ツールを制限する設定（KS4W_PACK_POLICY=locked、KS4W_LOCK_TOOLS の有効化、またはツールグループを指定する KS4W_MODE のリスト）があると、代わりに KS4W_READ_ONLY または KS4W_FORBID を使うよう案内するメッセージとともに起動が停止します。

更新チェックと更新通知。 ツールの使用後、サーバーは最大で週に1回、バックグラウンドで PyPI に問い合わせ、kitchensink4word の最新バージョンを確認します。このリクエストに含まれるのはパッケージ名とインストール済みのバージョンのみで、文書、ファイル名、識別情報は含まれません。新しいバージョンがあり、サーバーが uvx または Claude Desktop の拡張機能を通じて実行されている場合、アプリが対応していれば、AI アプリに「今すぐ更新」と「今はしない」のボタンを含む短い通知が表示されます。それ以外の場合は、AI が新しいバージョンについて一度だけ伝え、更新を提案します。通知で「今すぐ更新」を選ぶか、AI に更新を依頼しない限り、新しいバージョンがダウンロードまたはインストールされることはありません。通知を無効にするには、AI に KitchenSink4Word の更新通知をオフにするよう依頼してください。KS4W_UPDATE_NOTICES=off を設定すると、どこでも通知が無効になり、KS4W_UPDATE_CHECK=off を設定すると、更新チェックが完全に無効になります（旧設定の KS4W_NO_UPDATE_CHECK=1 も使用できます）。この設定はサーバー独自の状態フォルダーに保存されるため、更新後も保持されます。 サンドボックス化（任意）。 KS4W_ALLOWED_ROOTS に、Windows では ;（それ以外では :）で区切ったフォルダーのリストを設定します。例：%USERPROFILE%\Documents;D:\Work。設定すると、サーバーが読み書きするすべてのパスは、いずれかのフォルダー内に解決される必要があります。チェックは正規パスに対して行われるため、..\ によるパストラバーサル、シンボリックリンクやジャンクション、8.3形式の短い名前、拡張長パスプレフィックス、大文字小文字の細工、および許可された Documents の隣にある Documents2 のような類似フォルダー名は、すべて検出されます。ネットワーク（UNC）パスは、それらを含む UNC パス自体が許可されたルートでない限り拒否されます。ブロックされた呼び出しは、ファイルを開く前に、パスと許可されたルートを示す型付きエラーを返します。完全には信頼できないリクエストをサーバーが処理する場合は、設定することをお勧めします。

Word でのライブ編集

Word で開いているドキュメントで動作する操作です。デュアルモードの操作は自動的に振り分けられます（live='auto'）。それ以外の操作は、ファイルが閉じられるまで DOCUMENT_LOCKED を返します。1 つのサーバープロセス内の Word COM 呼び出しは直列化されます。ライブ呼び出しと、パスワードなしでの保存または終了も、マシン内のプロセス間ロックを使用します。同時に呼び出したクライアントは、Word に触れる前に APP_BUSY を受け取り、キューには追加されません。ライブ編集は com_save_document が呼び出されるまで未保存のままです。get_workflows(task='live-editing') で、この動作モデルを確認できます。

デュアルモード操作（ファイル＋ライブ）	ライブモードに関する注意事項
apply_edits	1 つの COM 元に戻すグループを使用します。挿入操作における Markdown のリスト／パイプテーブルは事前に拒否され、ファイルを閉じるよう案内されます。置換ではライブ範囲内の一致テキストを検証します。それ以外のインデックス指定操作は、最後に保存された状態に対してスナップショットの陳腐化ガードを実行します
delete_paragraphs	セクション区切り／フィールドをまたぐ範囲は拒否されます。range={} の位置指定エンドポイントでは、スナップショットの陳腐化ガードが実行されます
find_text	プレーンなクエリのみで、最大 500 件です。書式設定モードと include_textboxes はファイルモードのみです
format_text	書式設定モードはライブに振り分けられます。大文字小文字のモードはファイルモードのみです（live='force' の場合は拒否されます）。range={} の位置では、スナップショットの陳腐化ガードが実行されます
get_comments	同じ形式です
get_document_info	同じキー名を使用し、words／track_revisions を追加して、パーツリストは省略します
get_outline	同じフラットリスト形式です
get_text	本文の形式は同一です。include_textboxes／テキストボックスモードはファイルモードのみです
insert_paragraphs	heading_level は、数値定数を使って組み込みの Heading スタイルに対応付けられます（アウトラインベースのドキュメントでは、アウトラインレベルが直接設定されます）。inherit_format／copy_format_from はファイルモードのみです。テキストセレクターによる位置指定では、スナップショットの陳腐化ガードが実行されます
search_and_replace	プレーンな項目はライブに振り分けられます（255 文字の検索文字列にも対応します）。プレビューおよび find_formatting モードはファイルモードのみです（find_formatting で live='force' を指定した場合は拒否されます）
set_cells	プレーンテキストのセルのみです。垂直方向の結合はライブでは拒否されます
set_paragraph_format	shading／borders／tab_stops キーはライブでは拒否されます（XML レベルのため）。生のインデックスは v1 のインデックス信頼性契約に従います
set_paragraph_text	expect ガードが適用されます。変更履歴付きの段落は拒否されます。テキストセレクターによる位置指定では、スナップショットの陳腐化ガードが実行されます
word_count	Word 独自の統計エンジンを使用します。除外モードはファイルモードのみです

ライブ専用操作（ドキュメントを開いておく必要があります）：live_insert_at_cursor、live_repair、live_scroll_to、live_set_track_changes。
COM 層（Word アプリケーションを操作し、ドキュメントは開いていても閉じていてもかまいません）：com_export_pdf、com_import_pdf、com_multi_document、com_proofing_errors、com_readability_statistics、com_refresh_fields、com_save_document、com_validate_opens_clean、com_word_status。
開いているドキュメントの読み取りツール：get_document_view（最後に保存された状態を読み取り、その旨を示します）。

ドキュメントのファイルを読み取る、または変更するその他すべての操作はファイル専用です。ドキュメントが開いている間は拒否されます（ドキュメントを閉じるか、close=true を指定して com_save_document を使用してください）。

既知の制限事項

• ライブの正規表現による置換では、同じストーリー内の複雑なフィールドの後にある一致箇所がスキップされます。これは、Wordの文字オフセットがずれるためです。スキップされた数が報告され、プレーンテキストでの検索は引き続き機能します。
• ライブの set_cells は、セルが縦方向に結合された表を拒否します。ファイルベースのツールでは処理できますが、先にドキュメントを閉じてください。
• ライブの変更履歴の作成者情報はWordの動作に従います。WordでOfficeアカウントにサインインしている場合、変更履歴にはそのアカウントが記録されます。結果には、Wordが実際に使用した作成者が報告されます。
• 目次と図表一覧のページ番号を更新するには、フィールドの更新が必要です。ファイルを次に開いたときにWordが更新するか、com_refresh_fields を呼び出してください。
• ドキュメントのカスタムXMLにバインドされたコンテンツコントロールには、ファイルに保存されたテキストが表示されます。ファイルを開くと、Wordが保存済みデータから値を入力するため、両者が異なる場合があります。
• 極端に大きなドキュメントでは、一部の操作が急激に遅くなります。段落が100,000文字以上あり、その後に別の段落が追加されている場合、retrack_changes は1分以上かかり、長さに応じて処理時間が急速に増加します。また、セクションが1,000個あるドキュメントで set_header_footer を実行すると、数分かかります。呼び出しが制限時間に達すると、エラーで停止し、ファイルは変更されません。
• ディスク上のドキュメントでは、組み込みスタイルは、heading 2 や Caption など、Wordがすべての言語で保持している英語名、またはドキュメント独自のスタイルIDで指定します。Überschrift 2 のような他言語の名前は拒否され、拒否時にはドキュメントにあるスタイルIDが一覧表示されます。Wordで開いているドキュメントでは、スタイル名は指定されたとおりにWordへ渡されるため、別の言語でインストールされたWordでは、そのスタイルに対応する言語固有の名前が必要になる場合があります。

ヒューリスティックツール。 convert_citation_style、anonymize_for_review、validate(checks=["defined_terms"])、および validate(checks=["cross_references"]) のテキスト参照スキャンは、ヒューリスティックに基づいています。それぞれ、確信を持って処理できなかった項目の一覧を返すため、結果をそのまま信用せず、その一覧を確認してください。

2.x からのアップグレード

バージョン 3.0 では、2.2.x の 112 個のフラットなツールが、上記の 10 個のツールに再編成されています。enable_tools と disable_tools は廃止されましたが、それ以外のすべての操作名は維持されています。ただし、操作はツールの操作として呼び出すようになりました。たとえば、insert_paragraphs という名前のツールではなく、op="insert_paragraphs" を指定して word_edit を呼び出します。インストールコマンド、パッケージ名、word-mcp と kitchensink4word の各コマンドに変更はありません。

呼び出していたツール	現在のツール
get_text, get_document_view, find_text, list_elements, get_headers_footers, get_document_info, com_word_status, validate, diagnose_document, get_workflows, get_styles, get_outline, get_table, get_comments, get_tracked_changes, get_server_info, structured_diff, get_paragraph_format, word_count, get_revision_report, comment_report, get_protection, detect_citation_system, parse_references	word_read
insert_paragraphs, search_and_replace, delete_paragraphs, insert_break, apply_edits, delete_element, stamp_anchors, set_paragraph_text, redact_text	word_edit
define_style, apply_style, format_text, set_paragraph_format, change_heading_level, apply_manuscript_format	word_format
set_header_footer, set_section_properties, insert_list, create_table, set_table_properties, set_cells, delete_table, modify_table_structure, format_cells, sort_table, import_table, set_list_numbering, set_page_numbers, setup_chapter_headers, move_section	word_structure
insert_image, insert_field, set_image, export_images, insert_chart, set_chart_data, insert_equation, set_textbox_text, insert_hyperlink, insert_content_control, set_content_control, set_form_fields	word_media
manage_comment, resolve_revisions, anonymize_for_review, deanonymize_document, prepare_for_submission	word_review
manage_note, insert_caption, insert_reference_list, insert_bookmark, convert_notes, insert_cross_reference, mark_index_entry, insert_citation, insert_zotero_citation, search_zotero_library, manage_source, set_bibliography_style, convert_citation_style	word_references
insert_document, copy_document, create_document, manage_backups, set_document_properties, split_document, copy_table, apply_template, fill_template, mail_merge, assemble_front_matter, set_document_protection, set_watermark, fix_accessibility, export_table	word_document
com_save_document, live_insert_at_cursor, live_set_track_changes, com_refresh_fields, com_validate_opens_clean, com_multi_document, com_import_pdf, com_export_pdf, live_scroll_to, live_repair, com_proofing_errors, com_readability_statistics	word_app
enable_tools, disable_tools	廃止。すべての操作を最初から利用できます

一部の引数の表記が変わりましたが、以前の表記も引き続き使用できます。after_anchor は after_text に、anchor_text は at_text になりました。set_document_protection では read_only と tracked_changes を指定します。また、リストとページ番号の形式はスネークケース（lower_roman）になりました。stamp_anchors は get_document_view から独立した word_edit の操作に移動しました。動作にも変更があります。format_text と、テキストを検索して位置を特定する挿入ツールは、occurrence を指定して一致箇所を選ぶまで、曖昧な一致を拒否します。変更履歴とコメントには、作成者を指定しない限り Office のユーザー名が記録されます。また、保護された文書への書き込みは拒否されます。docs/surface_map.md には、2.2.1 の各ツールとその置き換え先がすべて記載されています。また、get_workflows の migrate-from-v2 レシピには、変更された引数も含め、同じ対応表が AI 向けに用意されています。変更履歴には、その他の変更がすべて記載されています。

1.x からのアップグレード

2.0 では、189 個のツールを以前のすべての機能を網羅する 110 個に統合した際、1.x のすべてのツール名が変更されました。まず移行ガイドをお読みください。各旧名称に対応する 2.x の名称が記載されています。続いて docs/surface_map.md で、その名称に対応する 3.0 のツールと操作を確認できます。get_workflows("migrate-from-v1") を実行すると、セッション内で最初のマップが返されます。

テスト

テストスイートには 4,525 件のテストがあります。そのうち 96 件は実際の Word ウィンドウを操作し、135 件は独自の非表示の Word を起動します。これらは Word をインストールした Windows でのみ実行されます。サンプル文書を必要とするテストでは、tests/make_corpus.py を使って構造的に同等の合成ファイルを生成するため、それ以外のテストスイートはどのマシンでも、すべてのプルリクエストでも実行できます。tests/word_validator.py は各出力を非表示の Word で開き、修復を求めるダイアログが表示されると失敗します。

Word を使わずにテストスイートを実行するには、次のようにします。

pytest tests -m "not live and not hidden_word"

問題の報告

issue を作成し、ツール名、実行した呼び出し、実際に起きたこと、期待した結果をお知らせください。AI に get_server_info を実行させ、その出力を貼り付けてください。この出力は安全に共有できるように設計されています。個人情報を含む文書は添付しないでください。セキュリティ上の問題については、代わりに SECURITY.md の手順に従ってください。

Business 版

Business 版では、これらのツールに Windows インストーラー、署名付き更新チャネル、Business 規約に基づくサポートが付属します。更新チェックにより対象となるリリースが利用可能になったことが通知されますが、何かが自動でインストールされることはありません。料金をご覧ください。Community 版は AGPL に基づき、規約に準拠する事業利用を含め、引き続き無料で利用できます。

貢献

バグ報告、修正、テスト、ドキュメントのご提供を歓迎します。CONTRIBUTING.mdをご覧ください。初めて貢献する方は、Contributor License Agreementに同意していただく必要があります。

AI を活用した作業の確認

AI アシスタントもソフトウェアも間違えることがあります。AI が編集した文書は、信頼して利用、共有、提出する前に必ず人が確認し、確認が済むまではバックアップを保管してください。KitchenSink4Word は保証なしで AGPL-3.0 に基づき提供されます。また、法律で認められる範囲において、その使用による結果について、作者および KitchenSink4AI は責任を負いません。ライセンスの第 15 条および第 16 条が適用されます。

ライセンス

KitchenSink4Word はデュアルライセンスです。

• AGPL-3.0. AGPL に準拠するあらゆる用途で、企業を含むすべての方が無料で利用できます。ソフトウェアを配布する場合、またはネットワーク経由で利用可能にする場合、変更内容を含むソースコードを共有する義務が規約に含まれます。
• 商用ライセンス. AGPL のソースコード共有義務を負わずに KitchenSink4Word を自社の製品やサービスに組み込みたい組織向けです。[email protected] までお問い合わせください。

Copyright (c) 2026 Alvut Consulting, LLC. KitchenSink4AI は Alvut Consulting, LLC の製品ラインです。KitchenSink4AI のツールは AI コーディングアシスタントの支援を受けて開発され、リリース前にすべてのテストスイートを実行しています。

Microsoft Corporation との提携、同社からの推奨または後援を受けていません。Microsoft および Word は Microsoft グループ企業の商標です。GitHub および Copilot は Microsoft グループ企業の商標です。Claude は Anthropic の商標です。Codex および OpenAI は OpenAI の商標です。その他すべての商標は、それぞれの所有者に帰属します。