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 : キャッシュの有効期限（時間）CACHE_CLEANUP_INTERVAL : キャッシュクリーンアップ間隔（時間）LOG_RETENTION_DAYS : ログ保持日数LOG_CLEANUP_INTERVAL : ログのクリーンアップ間隔（時間）
デフォルト設定
- キャッシュ構成
- キャッシュの有効期限: 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ファイルを参照してください。