Fastexcel MCP Server

🚀 FastExcel MCP サーバ

Java で実装されたモデルコンテキストプロトコル (MCP) サーバで、Excel 操作を行い、標準化されたヘッダーと列の関係マッピングをサポートします。

✨ 主な機能

• Excel ファイル（XLSX、XLS、CSV）のヘッダーとデータ行を読み取ります。
• 入力パスが設定されたワークスペース範囲内にあるかを検証します。
• 複数のシートとカスタムヘッダー行をサポートします。
• データ行の総数（ヘッダー行を除く）を取得します。
• 高速な繰り返しアクセスを実現するためのパフォーマンスキャッシュが組み込まれています。

⚠️ 重要提示

サーバは env: MCP_WORKSPACES で設定されたワークスペースディレクトリ内での操作のみ許可しています。

📚 ドキュメント

ツール

get_total_rows_number (キャッシュサポート付き)

Excel ファイルのデータ行の総数（ヘッダー行を除く）を取得します。

• 入力：
  • excelPath (文字列)：Excel ファイルの絶対または相対パス。
  • headRowNumber (整数)：ヘッダーがある行番号（1 から始まるインデックス）。
  • sheetName (文字列、オプション)：読み取るシート名。空の場合は最初のシートがデフォルトです。
• 出力：
  • データ行の総数を整数として返します。

get_sheet_names (キャッシュサポート付き)

Excel ファイル内のすべてのシート名とそのインデックスを取得します。

• 入力：
  • excelPath (文字列)：Excel ファイルの絶対または相対パス。
• 出力：
  • シート番号と名前を含むオブジェクトのリストを返します。

read_head_spec (キャッシュサポート付き)

Excel ファイルのヘッダー情報を解析して返します。

• 入力：
  • excelPath (文字列)：Excel ファイルの絶対または相対パス。
  • headRowNumber (整数)：ヘッダーがある行番号（1 から始まるインデックス）。
  • sheetName (文字列、オプション)：読み取るシート名。空の場合は最初のシートがデフォルトです。
• 出力：
  • 列インデックスとヘッダーを順番に並べたオブジェクトのリストを返します。

read_rows_spec (キャッシュサポート付き)

ヘッダーに関連付けられたデータ行の情報を解析して返します。

• 入力：
  • excelPath (文字列)：Excel ファイルの絶対または相対パス。
  • headRowNumber (整数)：ヘッダーがある行番号（1 から始まるインデックス）。
  • readRowNumbers (整数、オプション)：読み取るデータ行の数（ヘッダーを除く）。空の場合はすべてのデータ行を読み取ります。
  • sheetName (文字列、オプション)：読み取るシート名。空の場合は最初のシートがデフォルトです。
• 出力：
  • 行データとそれに対応するヘッダーを含むリストを返します。

cache_clear

メモリ内のすべての Excel ファイルのキャッシュデータをクリアします。

• 出力：
  • キャッシュが正常にクリアされた場合は true を返します。

test_cache_available

指定された Excel ファイルがキャッシュに存在するかをテストします。

• 出力：
  • ファイルがキャッシュにある場合は真を、そうでない場合は偽を返します。

💻 使用例

Claude Desktop を使用する場合は、設定ファイルに MCP サーバ情報を追加してください。

{
  "mcpServers": [
    {
      "name": "FastExcelMCP",
      "executable": "/path/to/javacExecutable",
      "options": ["-Dsome.option=value"],
      "jvmArgs": [],
      "workingDir": "."
    }
  ]
}

📦 インストール

JDK 17+ と Maven 3.9.6+ が必要です。以下のコマンドでビルドします。

mvn clean install

📄 ライセンス

このソフトウェアは Apache License 2.0 でライセンスされています。