Fastexcel MCP Server

🚀 FastExcel MCP サーバー

Javaで実装されたMCP（モデルコンテキストプロトコル）サーバーで、Excel操作を処理し、標準のヘッダ列関係をサポートします。

✨ 主な機能

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

⚠️ 重要提示

このサーバーは 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 (整数、オプション)：読み取るデータ行数（ヘッダーを除く）。nullの場合、すべてのデータ行を読み取ります。
    • sheetName (文字列、オプション)：読み取るシート名。空の場合、最初のシートがデフォルトで使用されます。
  • 行データとそのタイトルリンクを含むオブジェクトのリストを返します。

• cache_clear

  • メモリからすべてのキャッシュされたExcelファイルデータを削除します。
  • 削除に成功するとtrueを返します。

• test_cache_available

  • 指定されたExcelファイルがキャッシュに存在するかどうかを確認します。
  • 入力:
    • excelPath (文字列)：Excelファイルの絶対パスまたは相対パス。
  • ファイルがキャッシュに存在するかどうかを示すブール値を返します。

💻 使用例

基本的な使用法

Claude Desktopでこのサーバーを使用するには、以下の内容を構成ファイル claude_desktop_config.json に追加してください。

{
  "fastExcelMcpServer": {
    "enabled": true,
    "config": {
      "mcpEndpoint": "http://localhost:8080", // MCPサービスのエンドポイントアドレス
      "workSpaceRoot": "/path/to/workspace", // ワークスペースのルートディレクトリ
      "cacheExpiration": 3600, // キャッシュの有効期限（秒）
      "maxCacheSize": 1000 // 最大キャッシュファイル数
    }
  }
}

📦 インストール

環境要件

• JDK 8以上
• Maven 3.6以上

ビルドコマンド

このサーバーをプロジェクトで使用するには、以下のMavenコマンドを実行してください。

mvn clean install

📄 ライセンス

このサーバーはApache License 2.0に準拠しています。