このプロジェクトについて

Excel MCP Serverは、AIアシスタントにExcelワークブックの作成・読み取り・編集機能を提供するModel Context Protocolサーバーです。Microsoft Excelのインストールは不要です。.xlsx、.xlsm（マクロ保持）、.xltx、.xltmファイルで動作します。 機能 - セル、数式、日付の読み書き。大きなシート向けのページングとセル検索に対応。 - フォント、塗りつぶし、罫線、表示形式、列幅、ウィンドウ枠の固定などの書式設定。 - 構造の管理：シート、行と列、結合セル、テーブル、グラフ、集計テーブル。 - ルールの適用：条件付き書式、ドロップダウンや数値制限などのデータ検証。 - .xlsmファイル内のVBAコードをモジュール単位で読み取り（読み取り専用、実行は一切なし）。 安全機能 - --allow-dirまたはEXCEL_FILES_PATHによる任意のフォルダ制限。相対パスは許可されたフォルダ内で解決されます。 - 数式の安全性チェックにより、ネットワーク、他のプログラム、ホスト情報にアクセスする関数（例：WEBSERVICE、HYPERLINK、IMAGE、RTD、CALL、INFO、INDIRECT）、DDEリンク、外部ワークブック参照を拒否します。 - 読み取り専用モード、最大ファイルサイズ（既定100 MB）、1回の呼び出しあたり100,000セル制限、アトミック保存。 - HTTPモードは既定でlocalhostで待ち受けます。リモートアクセスにはベアラートークンが必要で、TLS終端リバースプロキシの使用を推奨します。 セットアップ クライアントは通常、uvx excel-mcp-server stdioでサーバーを起動し、必要に応じて--allow-dirを指定します。文書化されている連携先にはClaude Desktop（.mcpbバンドルを含む）、Claude Code、Cursor、GitHub Copilot付きVS Code、OpenAI Codex、Gemini CLI、Devin Desktopがあります。Streamable HTTPモードも利用可能で、Dockerをサポートします。 ツール領域には、ワークブック（作成、記述、一覧、エクスポート、インポート）、シート（記述、作成、名前変更、コピー、削除、行または列の挿入・削除）、セル（read_range、write_range、clear_range、copy_range、find_cells）、書式設定（format_range、merge_cells、set_sheet_layout、add_conditional_format、add_data_validation）、オブジェクト（create_table、create_chart、create_summary_table）、マクロ（read_vba）があります。 制限事項 - 数式は保存されるだけで計算されません。値モードはExcelが最後に保存した結果を返すため、新しく書き込んだ数式はExcelまたはLibreOfficeで開いて保存するまで空として読み取られます。 - 従来の.xlsおよび.csvファイルはサポートされません。 - create_summary_tableは静的な集計を書き込みます。実際のピボットテーブルは作成されません。 - 行や列の挿入・削除は、移動したセルを参照する数式、グラフ、テーブルを更新しません。 - 図形、スライサー、一部の埋め込みオブジェクトなど、openpyxlが理解しない機能は編集時に失われる可能性があります。.xlsmファイル内の画像、グラフ、テーブル、マクロは保持されます。 バージョン1.0ではツールの名前変更と再設計が行われ、SSEトランスポートが削除され、Python 3.11以降が必要です。MITライセンスの下で提供されています。