hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Excel MCP サーバー

简体中文| English

モデルコンテキストプロトコル (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ツール

構造ツール

Excel構造を分析する
- 機能: シートリストと列ヘッダーを含む Excel ファイル構造を JSON 形式で取得します。
- パラメータ:
  - fileAbsolutePath: Excelファイルの絶対パス
  - headerRows: ヘッダー行の数（デフォルト: 1）
エクスポートExcel構造
- 機能: Excel ファイル構造 (シートとヘッダー) を新しい Excel テンプレートファイルにエクスポートします。
- パラメータ:
  - sourceFilePath: ソース Excel ファイルパス
  - targetFilePath: 対象の Excel ファイルパス
  - headerRows: ヘッダー行の数（デフォルト: 1）

読み取りツール

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

書き込みツール

シート名によるデータ書き込み
- 機能: Excel ファイル内の特定のシートにデータを書き込みます (シートが存在する場合は上書きします)
- パラメータ:
  - fileAbsolutePath: Excelファイルの絶対パス
  - sheetName: 書き込むシートの名前
  - data: 書き込むデータの配列
シートデータの書き込み
- 機能: 提供されたデータで新しい Excel ファイルを作成する
- パラメータ:
  - fileAbsolutePath: 新しい Excel ファイルの絶対パス
  - data: 複数のシートデータを含むオブジェクト

キャッシュツール

クリアファイルキャッシュ
- 機能: 指定された 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
タイプスクリプト: ^5.8.2

開発依存関係

@types/ノード: ^22.13.10
ノードモン: ^3.1.9
ts-node: ^10.9.2

ライセンス

このプロジェクトはMITライセンスに基づいてライセンスされています。つまり、以下のことが自由に行えます。

ソフトウェアを商用または非商用の目的で使用する
ソースコードを変更する
オリジナルまたは改変したコードを配布する要件:
元の著作権表示を保持する
ソフトウェアの使用に関して著者に対して一切の責任を負いかねます。詳細なライセンス情報については、 LICENSEファイルを参照してください。

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

ワークシート管理、構造分析、自動キャッシュの機能を備え、モデルコンテキストプロトコルを通じて Excel ファイルのシームレスな読み取り、書き込み、分析を可能にします。

Related Resources

Reddit Discussion about this server

Excel MCP Server