KitchenSink4PPT

KitchenSink4PPT

AI アシスタントを使って PowerPoint のスライドデッキを作成・修正できます。図は後から編集可能な図形で作成されます。

AI は PowerPoint で 193 種類の操作を実行でき、変更のたびにバックアップが作成されます。また、複数の図形を指している可能性がある場合は、推測せずに質問します。

KitchenSink4PPT は MCP サーバーです。Claude Code、Codex CLI、Copilot CLI、Claude Desktop などのローカル MCP クライアントで、.pptx ファイルを作成・編集できます。図は PowerPoint のネイティブ図形と接着コネクタで作成されるため、AI の作業後もスライドを自分で調整できます。これは AGPL-3.0 でライセンスされた無料のコミュニティ版です。

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

**プラットフォーム：**ファイルツールは Windows と Linux で動作します（このリリースでは macOS は未テストです）。PowerPoint で開いているスライドデッキを編集するには、PowerPoint がインストールされた Windows が必要です。PDF および画像へのエクスポートには、Windows 版 PowerPoint または対応する LibreOffice が必要です。

インストール

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

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

claude mcp add ppt -s user -- uvx kitchensink4ppt

codex mcp add ppt -- uvx kitchensink4ppt

Claude Desktop。 uv をインストールし、Claude Desktop を再起動してください。最新リリースから .mcpb ファイルをダウンロードし、Settings > Extensions > Advanced settings > Install extension を開いてファイルを選択します。初回起動時に Python パッケージがダウンロードされるため、ネットワーク接続が必要です。

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

pip install kitchensink4ppt

任意：pip install "kitchensink4ppt[metrics]" を実行すると、インストール済みフォントを使ったテキストのフィッティングとオーバーフローチェックの測定機能が追加されます。結果はあくまで推定値なので、スライドをレンダリングして確認してください。

できること

• テンプレートからスライドデッキを作成し、テキストや発表者ノートを修正します。
• 編集可能な図形と接着コネクタで図を描いたり、タイムライン、組織図、マトリックス、サイクル、比較図を 1 回の呼び出しで生成したりできます。
• SVG グラフィックをネイティブの PowerPoint 図形に変換します。
• オブジェクトを整列し、一貫性のあるフォント、色、テーマ、レイアウトを適用します。
• 同僚が引き続き編集できる表やグラフを作成します。
• スライドデッキの結合、分割、比較を行い、レビューコメントに対応します。
• スライドのアクセシビリティ上の問題を確認し、対応している修正を適用します。
• レンダリングアプリケーションがインストールされている場合、PDF またはスライド画像にエクスポートします。

サーバーは合計で 9 個のツールに 145 個の操作を提供し、各操作で実行できるアクション（たとえば、各種の切り替えや整列）を数えると 193 個になります。起動時に必要な AI の作業メモリは、ツール一覧全体で約 7.3k トークンです。数値は scripts/measure_surface.py と scripts/count_operations.py から取得しています。

KitchenSink4Word（Word）、KitchenSink4XL（Excel）、KitchenSink4Web（ウェブページ）も、同じ方法で構築されています。

図の画像ではなく、本物の図形

svg_to_shapes は、SVG をネイティブの PowerPoint 図形で構成されるグループ化されたツリーに変換します。カスタムジオメトリ、グラデーション、線、テキスト、入れ子になったグループに対応しています。ラスタライズは行わず、外部サービスも呼び出さないため、ビルドに PowerPoint をインストールする必要もありません。すべての図形がそれぞれ ID を保持するため、後から特定のノードの色を変更したり、ボックスのサイズを調整したり、ラベルを書き換えたりできます。

コネクタは接続されています。ノードを動かすと、それに合わせて矢印も移動します。まるで誰かが手作業で図を描いたかのように動くため、デッキを受け取った人は再生成せずに、どの部分でも調整できます。

insert_shape（プリセットとフリーフォームジオメトリ）、insert_connector（直線、エルボー、曲線、矢印付き）、group_shapes、align_shapes、distribute_shapes、set_z_order を使って、図を一から作成できます。また、export_slide_image は PNG をレンダリングするため、AI が作成した図を確認して修正できます。

ツールパックとコンテキストコスト

サーバーは最初のメッセージから、9 つのツールをすべて提示します。ppt_help 以外の各ツールには、実行する操作を指定する op と、引数（.pptx へのパスを含む）を指定する args が必要です。すべて最初から利用でき、切り替えは不要です。トークン数は、クライアントが受け取る tools/list エントリー全体を数えたもので、scripts/measure_surface.py による測定値です。ppt_help は任意の操作の引数と動作する例を返し、不明な引数は無視せず拒否します。スライドを指定するには、通常の数え方で 1 から始まる slide_number、または 0 から始まる slide を使います。特定のスライドに関する回答には、すべてそのスライドの番号とタイトルが含まれます。

ツール	操作数	トークン数の目安	対応範囲
ppt_read	18	~1.0k	すべてのスライドに安定したアドレスを付けてテキストとしてデッキを読み取る、テキストの検索、要素の一覧表示、表、グラフ、ノート、コメント、数式、ハイパーリンクの読み取り、get_server_info と get_workflows
ppt_inspect	17	~0.9k	アクセシビリティ、レイアウトとオーバーフローのチェック、フォント一覧、デッキ比較、統計、ブランド情報の抽出、テーマ、ドキュメントのプロパティ、diagnose、PowerPoint の状態など、変更を加えない監査
ppt_edit	19	~0.9k	apply_edits による一括編集、検索と置換、プレースホルダーテキスト、テキストのフィッティングと書式設定、箇条書き、ハイパーリンク、ノート、スライドの挿入、削除、複製、並べ替え、移動、非表示
ppt_graphics	27	~1.2k	図形とその調整ハンドル、接着コネクタ、SVG コンパイラー、1 回の呼び出しで使える図表生成ツール、グループ化、配置、重ね順、画像、動画、音声、数式、代替テキストと読み上げ順序、別のデッキからの図形またはグループのコピー
ppt_tables	16	~0.7k	セルの編集、結合と解除、行と列の挿入と削除、罫線と塗りつぶし、幅と高さ、組み込みスタイル、CSV と JSON のインポートに対応した表、編集可能なデータを持つグラフ
ppt_design	19	~0.9k	スライドサイズ、レイアウト、テーマの色とフォント、ブランドの適用、背景、マスターとレイアウトの編集、デッキ全体のフォントと色の置換、画面切り替えと開始時のアニメーション
ppt_review	7	~0.6k	スレッド形式のコメント（追加、返信、解決、削除）と、レビュー用のデッキの匿名化。また、依頼に応じてサーバーを更新（update_now）し、更新通知のオン・オフを切り替えます（update_notices）
ppt_deck	22	~1.0k	テンプレート、コピー、スナップショット、バックアップからの新規プレゼンテーション作成、デッキ間のスライドのコピー、結合と分割、PDF、PNG、図形画像、配布資料へのエクスポート、目次スライド、フッター、圧縮、検証、PowerPoint で開いているデッキの保存またはスクロール
ppt_help	n/a	~0.2k	任意の操作の引数と例
9 つすべて	145	~7.3k	最初に一度だけ読み込まれ、後から切り替える必要はありません

手順については、AI に get_workflows を呼び出すよう依頼してください。図表の作成、テンプレート、表の手順が含まれており、各ステップで適切なツールが示されています。サーバー独自の指示により、上記の数値に約 500 トークンが加わります。より範囲を絞ったサーバーにしたい管理者は、KS4P_READ_ONLY=1 を設定するか、削除する項目を KS4P_FORBID に列挙できます（「設定」を参照）。削除した項目はコストに含まれなくなります。

安全モデル

• アトミックで検証済みの保存。 変更のたびに、パッケージをメモリ内で再構築して検証した後、新しいファイルを古いファイルと入れ替えます。操作に失敗しても、元のファイルは完全にそのままです。Windows では、デッキの Mark of the Web と作成日時を保持するため、ダウンロードしたデッキは引き続き保護ビューで開きます。ファイルシステムとフォルダーで許可されている場合はデッキ固有のアクセス許可を保持し、許可されていない場合はフォルダーのアクセス許可を引き継ぎ、その旨を警告で知らせます。保存中、通常は数ミリ秒間、ほかのプログラムからデッキが見えなくなることがありますが、このサーバーの読み取りはその間待機します。
• 変更の前にバックアップを作成。 現在のバージョンは、デッキと同じ場所にある非表示の .ks4p-backups/ フォルダー内の prev.pptx と anchor.pptx にローテーションされます。create_snapshot は同じ非表示フォルダー内に恒久的なコピーを保存します。このコピーはローテーションも削除もされません。dest_dir を指定すると、代わりにそこへ見えるコピーを保存します。コピーの名前はデッキに基づくため、デッキより新しい日付が先頭に付くことはありません。manage_backups では、すべてのバックアップの一覧表示と復元（復元自体も元に戻せます）、およびローテーション対象のバックアップの削除ができます。
• 変更しない部分はそのまま保持。 呼び出しで変更しない部分はバイト単位でそのまま書き戻されるため、ほかのスライドを編集しても、テーマ、メディア、アニメーションは保持されます。
• 推測せずに拒否。 対象が曖昧な場合は候補の一覧とともに拒否し、結合セルの範囲を分割する編集は拒否し、アンカーが古いバッチは何も変更する前に拒否します。拒否はそれぞれ構造化されており（{ok: false, error: {code, message, hint}}）、次に実行する呼び出しを示します。
• ロック。 1つのファイルへの変更は、サーバー内およびプロセス間で直列化されます。PowerPoint で開いているデッキは保存済みのファイルから読み取られ、その旨が応答で示されます。ファイルツールはリスクを避けるため、そのデッキへの変更を拒否します。
• PowerPoint の操作はユーザーのものです。 サーバーは、自ら起動した場合にのみ PowerPoint プロセスを終了します。また、停止した呼び出しはアプリケーションを強制終了せず、安全にキャンセルします。
• 暗号化ファイルと読み取り専用ファイル。 暗号化されたプレゼンテーションは Office を呼び出す前に拒否され、読み取り専用ファイルはその旨が通知されます。

プライバシー

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

設定

変数	効果
KS4P_READ_ONLY	1 にすると、ファイルを変更するすべてのツールが削除され、ppt_read、ppt_inspect、ppt_help のみが残ります
KS4P_FORBID	削除するツール名または操作名をカンマ区切りで指定します。例：export_pdf,ppt_review。ppt_app も名前として指定でき、PowerPoint を起動する、または接続するすべての機能が削除されます
KS4P_ALLOWED_ROOTS	オプションのサンドボックスです。ツールは、これらのフォルダー外にあるファイルの操作を拒否します
KS4P_CALL_TIMEOUT_S	単一の呼び出しが安全にキャンセルされるまで実行できる秒数（デフォルトは 120）
KS4P_MAX_OUTPUT_CHARS	1 回の応答の最大サイズです。大きなデッキはページごとに読み込まれます（デフォルトは 52,000 文字）
KS4P_UPDATE_CHECK	off にすると、更新チェックが完全に無効になります（KS4P_NO_UPDATE_CHECK=1 も使用できます）
KS4P_UPDATE_NOTICES	off にすると更新通知が無効になり、通知を無効にした後で on にすると再び有効になります
KS4P_AUTHOR	呼び出しで作成者が指定されていない場合に、コメントや返信に署名する名前です。user（デフォルト）では自分の名前、Office のユーザー名、またはいずれもない場合は Windows のサインイン名が使われます。assistant では「AI Assistant via KS4PPT」として署名されます。また、設定にかかわらず、author="assistant" を渡す呼び出しも同様に署名されます
KS4P_COMMENT_AUTHOR	呼び出しで作成者が指定されていないコメントや返信すべてに署名する名前です。KS4P_AUTHOR の設定より優先されます。ここで設定された場合も、呼び出しの author として渡された場合も、メールアドレスは署名に使われません。次の候補の名前が使われ、その旨が応答で通知されます

サーバーが使用できない値がある場合、推測で補うのではなく、簡潔なメッセージを表示して起動を停止します。該当するのは、読み取れない KS4P_READ_ONLY、KS4P_CALL_TIMEOUT_S、KS4P_MAX_OUTPUT_CHARS、KS4P_AUTHOR、ツール名または操作名ではない名前が指定された KS4P_FORBID、あるいはツールをロックする廃止済みの設定（KS4P_PACK_POLICY=locked など）です。サーバーが認識しない変数名は無視されるため、KS4P_READ_ONY のような入力ミスをしても効果はありません。スペルを確認してください。get_server_info では、サーバーが読み取り専用かどうか、および禁止されている機能を確認できます。

更新チェックと更新通知。 サーバーは、ツールの使用後、最大で週に 1 回、バックグラウンドで PyPI に問い合わせて、kitchensink4ppt の最新バージョンを確認します。このリクエストに含まれるのはパッケージ名とインストール済みバージョンのみで、デッキ、ファイル名、識別子は含まれません。新しいバージョンがあり、サーバーが uvx または Claude Desktop 拡張機能経由で動作している場合、対応するアプリでは「今すぐ更新」と「後で」を含む短い通知が表示されます。それ以外の場合は、AI が新しいバージョンについて一度だけ通知し、更新を提案します。通知で「今すぐ更新」を選ぶか、AI に更新を依頼しない限り、新しいバージョンがダウンロードまたはインストールされることはありません。通知を無効にするには、AI に KitchenSink4PPT の更新通知をオフにするよう依頼してください。KS4P_UPDATE_NOTICES=off ですべての環境で通知を無効にでき、KS4P_UPDATE_CHECK=off ではチェック自体が完全に無効になります（旧設定の KS4P_NO_UPDATE_CHECK=1 も使用できます）。この設定はサーバー独自の状態フォルダーに保存されるため、更新後も維持されます。

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

バージョン 2.0 では、1.3.1 の142個の独立したツールを、上記の9個のツールに再編成しました。1.3.1 のすべての操作は引き続き利用できますが、グループツールの操作として呼び出すようになりました。たとえば、svg_to_shapes という名前のツールではなく、op: "svg_to_shapes" を指定して ppt_graphics を呼び出します。引数が変更された操作もあるため、初めて呼び出す前に ppt_help で確認してください。

• docs/surface_map.md では、1.3.1 の各ツールと、それに置き換わるツールおよび操作を一覧にしています。
• get_workflows の migrate-from-v1 レシピでは、同じ対応表を AI に提供するため、保存済みのプロンプトやスクリプトを変換できます。
• すべての操作が最初から利用できるため、enable_tools と disable_tools は廃止されました。起動設定の KS4P_MODE、KS4P_PACK_POLICY、KS4P_ALL_TOOLS、KS4P_LOCK_TOOLS も廃止されました。以前のバージョンの設定は自動的に処理されます。古い既定値（KS4P_MODE=lite、full または everything、KS4P_PACK_POLICY=auto、KS4P_ALL_TOOLS、KS4P_LOCK_TOOLS=false）は1行の通知とともに無視され、ツールを固定する設定（KS4P_PACK_POLICY=locked、KS4P_LOCK_TOOLS=true、またはツールグループのリストを指定した KS4P_MODE）がある場合は、代わりに使用すべき設定を示すメッセージとともに起動を停止します。サーバーが提供する機能を制限するには、KS4P_READ_ONLY と KS4P_FORBID を使用してください（「設定」を参照）。
• インストールコマンド、パッケージ名、kitchensink4ppt コマンドに変更はありません。

その他の変更点は、変更履歴をご覧ください。

テスト

ファイル層（パッケージ、スライド、テキスト、グラフィック、表、グラフ、コメント、アニメーション、テーマ、リンク、メディア、ノート、マスター、数式、アクセシビリティ、組み立て、スイープ、エクスポート）は、生成したプレゼンテーションファイルが PowerPoint で問題なく開けることの確認を含む、3,689件のテストで網羅されています。また、サーバーは stdio を介したプロトコルのラウンドトリップテストにも合格します。サンプルのプレゼンテーションファイルが必要なテストでは合成データを使って生成するため、どのマシンでもテストスイートを実行できます。PowerPoint で開いているプレゼンテーションファイルを編集する場合、すべての呼び出しはプロセス全体で共有するロックを通り、ダイアログの検出と上限付きタイムアウトも適用されます。

問題の報告

問題を報告するには、依頼した内容、実際に起きたこと、期待していたことを添えて、issue を作成してください。AI に diagnose を実行させ、その出力を貼り付けてください。共有しても安全な内容になるよう設計されています。個人情報などが含まれるプレゼンテーションファイルは添付しないでください。セキュリティ上の問題については、SECURITY.md に従ってください。

Business 版

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

貢献

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

ライセンス

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

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

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

Microsoft Corporation との提携、同社による承認、または同社のスポンサーを受けていません。Microsoft および PowerPoint は Microsoft グループ企業の商標です。GitHub および Copilot は Microsoft グループ企業の商標です。Claude は Anthropic の商標です。Codex および OpenAI は OpenAI の商標です。その他すべての商標は、それぞれの所有者に帰属します。