Excel MCP Server

Excel MCP サーバー

简体中文 | 日本語

Model Context Protocol（MCP）に基づく Excel ファイル処理サーバーで、Excel ファイルの読み取り、書き込み、分析機能を提供します。

機能

• 📖 Excel ファイルの読み取り

  • ワークシートの一覧を取得
  • 指定したワークシートのデータを読み取り
  • すべてのワークシートのデータを読み取り

• ✍️ Excel ファイルの書き込み

  • 新しい Excel ファイルを作成
  • 指定したワークシートに書き込み
  • 複数のワークシートに対応

• 🔍 Excel の構造を分析

  • ワークシートの構造を分析
  • 構造を新しいファイルにエクスポート

• 💾 キャッシュ管理

  • ファイル内容を自動的にキャッシュ
  • キャッシュを定期的にクリーンアップ
  • キャッシュを手動で消去

• 📝 ログ管理

  • 操作を自動的に記録
  • ログを定期的にクリーンアップ

インストール

Smithery 経由でインストール

Smithery 経由で Claude Desktop に excel-mcp-server を自動的にインストールするには：

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

手動でインストール

NPM 経由でインストール 以下の設定を MCP サーバーの設定に追加すると、excel-mcp-server を自動的にインストールできます。

Windows プラットフォーム：

{
  "mcpServers": {
    "excel": {
        "command": "cmd",
        "args": ["/c", "npx", "--yes", "@zhiweixu/excel-mcp-server"],
        "env": {
            "LOG_PATH": "[set an accessible absolute path]",
            "CACHE_MAX_AGE": "1",
            "CACHE_CLEANUP_INTERVAL": "4",
            "LOG_RETENTION_DAYS": "7",
            "LOG_CLEANUP_INTERVAL": "24"
        }
    }
}

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

{
  "mcpServers": {
    "excel": {
        "command": "npx",
        "args": ["--yes", "@zhiweixu/excel-mcp-server"],
        "env": {
            "LOG_PATH": "[set an accessible absolute path]",
            "CACHE_MAX_AGE": "1",
            "CACHE_CLEANUP_INTERVAL": "4",
            "LOG_RETENTION_DAYS": "7",
            "LOG_CLEANUP_INTERVAL": "24"
        }
    }
}

注：LOG_PATH は任意です。設定しない場合、ログはアプリケーションのルートディレクトリにある「logs」フォルダーに保存されます。その他の引数も任意です。

API ツール

構造ツール

1. analyzeExcelStructure

   • 機能：シート一覧と列ヘッダーを含む Excel ファイルの構造を JSON 形式で取得
   • パラメーター：
     • fileAbsolutePath：Excel ファイルの絶対パス
     • headerRows：ヘッダー行数（デフォルト：1）

2. exportExcelStructure

   • 機能：Excel ファイルの構造（シートとヘッダー）を新しい Excel テンプレートファイルにエクスポート
   • パラメーター：
     • sourceFilePath：ソース Excel ファイルのパス
     • targetFilePath：ターゲット Excel ファイルのパス
     • headerRows：ヘッダー行数（デフォルト：1）

読み取りツール

1. readSheetNames

   • 機能：Excel ファイルからすべてのシート名を取得
   • パラメーター：
     • fileAbsolutePath：Excel ファイルの絶対パス

2. readDataBySheetName

   • 機能：Excel ファイル内の特定のシートからデータを取得
   • パラメーター：
     • fileAbsolutePath：Excel ファイルの絶対パス
     • sheetName：読み取るシートの名前
     • headerRow：ヘッダー行番号（デフォルト：1）
     • dataStartRow：データ開始行番号（デフォルト：2）

3. readSheetData

   • 機能：Excel ファイル内のすべてのシートからデータを取得
   • パラメーター：
     • fileAbsolutePath：Excel ファイルの絶対パス
     • headerRow：ヘッダー行番号（デフォルト：1）
     • dataStartRow：データ開始行番号（デフォルト：2）

書き込みツール

1. writeDataBySheetName

   • 機能：Excel ファイル内の特定のシートにデータを書き込み（シートが存在する場合は上書き）
   • パラメーター：
     • fileAbsolutePath：Excel ファイルの絶対パス
     • sheetName：書き込むシートの名前
     • data：書き込むデータの配列

2. writeSheetData

   • 機能：指定したデータを含む新しい Excel ファイルを作成
   • パラメーター：
     • fileAbsolutePath：新しい Excel ファイルの絶対パス
     • data：複数のシートデータを含むオブジェクト

キャッシュツール

1. clearFileCache
   • 機能：指定した Excel ファイルのキャッシュデータを消去
   • パラメーター：
     • fileAbsolutePath：キャッシュから消去する Excel ファイルの絶対パス

設定

環境変数

• LOG_PATH：ログファイルの保存先

  • 任意
  • デフォルト：アプリケーションのルートディレクトリにある「logs」フォルダー

• CACHE_MAX_AGE：キャッシュの有効期限（時間）

  • 任意
  • デフォルト：1

• CACHE_CLEANUP_INTERVAL：キャッシュのクリーンアップ間隔（時間）

  • 任意
  • デフォルト：4

• LOG_RETENTION_DAYS：ログの保持日数

  • 任意
  • デフォルト：7

• LOG_CLEANUP_INTERVAL：ログのクリーンアップ間隔（時間）

  • 任意
  • デフォルト：24

デフォルト設定

• キャッシュ設定

  • キャッシュの有効期限：1 時間
  • キャッシュのクリーンアップ間隔：4 時間

• ログ設定

  • ログの保持日数：7 日
  • クリーンアップ間隔：24 時間

依存関係

• @modelcontextprotocol/sdk: ^1.7.0
• xlsx: ^0.18.5
• typescript: ^5.8.2

開発依存関係

• @types/node: ^22.13.10
• nodemon: ^3.1.9
• ts-node: ^10.9.2

ライセンス

このプロジェクトは MIT ライセンスのもとで公開されています。以下のことが自由に行えます。

• 商用または非商用目的でソフトウェアを使用する

• ソースコードを変更する

• オリジナルまたは変更後のコードを配布する 要件：

• 元の著作権表示を保持する

• ソフトウェアの使用に関して、作者に対する責任を問うことはできません ライセンスの詳細については、LICENSE ファイルをご覧ください。