Excel MCP Server

🚀 Excel MCP サーバー

Excel MCP サーバーは、Model Context Protocol (MCP) をサポートするサーバーで、Microsoft Excel データの読み取りと書き込みを行うことができます。

🚀 クイックスタート

Excel MCP サーバーは、Model Context Protocol (MCP) をサポートし、Microsoft Excel データの読み取りと書き込みを行うことができます。

✨ 主な機能

• MS Excel ファイルからテキスト値を読み取る
• MS Excel ファイルにテキスト値を書き込む
• MS Excel ファイルから数式を読み取る
• MS Excel ファイルに数式を書き込む

🪟Windowsのみ：

• MS Excel ファイルをリアルタイムで編集する
• ファイルのスクリーン画像をキャプチャする

詳細については、ツール セクションを参照してください。

📦 インストール

NPM を通じたインストール

excel-mcp-server は、MCP サーバー構成に自動的に以下の設定を追加します。

Windows の場合：

{
    "mcpServers": {
        "excel": {
            "command": "cmd",
            "args": ["/c", "npx", "--yes", "@negokaz/excel-mcp-server"],
            "env": {
                "EXCEL_MCP_PAGING_CELLS_LIMIT": "4000"
            }
        }
    }
}

その他のプラットフォームの場合：

{
    "mcpServers": {
        "excel": {
            "command": "npx",
            "args": ["--yes", "@negokaz/excel-mcp-server"],
            "env": {
                "EXCEL_MCP_PAGING_CELLS_LIMIT": "4000"
            }
        }
    }
}

Smithery を通じたインストール

Claude Desktop 用に Excel MCP Server を自動的にインストールするには、Smithery を通じて以下のコマンドを実行します。

npx -y @smithery/cli install @negokaz/excel-mcp-server --client claude

📚 ドキュメント

要求事項

• Node.js 20.x 以上

サポートされるファイル形式

• xlsx（Excel ワークブック）
• xlsm（マクロ付き Excel ワークブック）
• xltx（Excel テンプレート）
• xltm（マクロ付き Excel テンプレート）

ツール

read_sheet_names

Excel ファイル内のすべてのシート名を一覧表示します。

パラメータ：

• fileAbsolutePath
  • Excel ファイルの絶対パス

read_sheet_data

Excel シートのデータをページングで読み取ります。

パラメータ：

• fileAbsolutePath
  • Excel ファイルの絶対パス
• sheetName
  • Excel ファイル内のシート名
• range
  • 読み取る Excel シートの範囲（例："A1:B2"）。
• 範囲が指定されていない場合、デフォルトで最初のセルからページングで読み取ります。

read_sheet_data_with_range

Excel シートの指定された範囲のデータをページングで読み取ります。

パラメータ：

• fileAbsolutePath
  • Excel ファイルの絶対パス
• sheetName
  • Excel ファイル内のシート名
• startRow
  • 読み取りを開始する行番号
• endRow
  • 読み取りを終了する行番号
• 一度に読み取れるセルの最大数は 4000 です。

read_sheet_formula

Excel シート内の数式をページングで読み取ります。

パラメータ：

• fileAbsolutePath
  • Excel ファイルの絶対パス
• sheetName
  • Excel ファイル内のシート名

write_sheet_data

Excel シートにデータを書き込みます。

パラメータ：

• fileAbsolutePath
  • Excel ファイルの絶対パス
• sheetName
  • Excel ファイル内のシート名
• data
  • 書き込むデータ（例：{A1: "value"}）

write_sheet_formula

Excel シートに数式を書き込みます。

パラメータ：

• fileAbsolutePath
  • Excel ファイルの絶対パス
• sheetName
  • Excel ファイル内のシート名
• formula
  • 書き込む数式（例：{A1: "=A2+B2"}）

設定

以下の環境変数を使用して、MCP サーバーの動作を変更できます。

EXCEL_MCP_PAGING_CELLS_LIMIT

ページング操作で一度に読み取るセルの最大数です。 [デフォルト値：4000]

📄 ライセンス

Copyright (c) 2025 Kazuki Negoro

excel-mcp-server は MIT License の下で公開されています。