Negokaz Excel MCP Server

🚀 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 のみ）

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

📦 インストール

システム要件

• Node.js 20.x 以上

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

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

インストール方法

NPM を使用したインストール

Excel MCP サーバーを自動でインストールするには、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"
            }
        }
    }
}

史密瑟リを使用したインストール

Claude Desktop 用に Excel MCP サーバーを自動でインストールするには、史密瑟リを使用します。

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

📚 ドキュメント

ツール

read_sheet_names

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

パラメータ：

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

read_sheet_data

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

パラメータ：

• fileAbsolutePath
  • Excel ファイルの絶対パス
• sheetName
  • Excel ファイル内のシート名
• range（オプション）
  • 読み取り範囲。形式は "A1:B2"。
  • デフォルト値：シート全体
• returnHeaders（オプション）
  • 列ヘッダーを返すかどうか。デフォルトは true。

read_sheet_data_all

Excel ファイル内のすべてのシートのデータをページングで読み取ります。

パラメータ：

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

write_sheet_data

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

パラメータ：

• fileAbsolutePath
  • Excel ファイルの絶対パス
• sheetName
  • 書き込み先のシート名
• data
  • 書き込むデータ。形式は {row: number, column: string, value: any}
• headers（オプション）
  • 最初の行にヘッダーを追加するかどうか。デフォルトは true。

write_sheet_data_all

Excel ファイル内のすべてのシートにデータを書き込みます。

パラメータ：

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

環境変数の設定

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

EXCEL_MCP_PAGING_CELLS_LIMIT

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

📄 ライセンス

Copyright (c) 2025 Kazuki Negoro

Excel MCP サーバーは MIT License の下で公開されています。