MCP Excel Reader

MCP Excel Reader

自動チャンク分割とページネーションに対応した、Excel ファイルを読み取るための Model Context Protocol（MCP）サーバーです。SheetJS と TypeScript を使用して構築されており、大きな Excel ファイルを扱いやすいサイズのチャンクに自動的に分割することで、効率的な処理をサポートします。

機能

• 📊 サイズ制限を自動で適用して Excel ファイル（.xlsx、.xls）を読み取ります
• 🔄 大規模なデータセットを自動でチャンク分割します
• 📑 シートの選択と行のページネーションに対応します
• 📅 日付を適切に処理します
• ⚡ 大きなファイル向けに最適化されています
• 🛡️ エラー処理と検証に対応しています

インストール

Smithery 経由でインストールする

Smithery 経由で Claude Desktop 用の Excel Reader を自動的にインストールするには：

npx -y @smithery/cli install @ArchimedesCrypto/excel-reader-mcp-chunked --client claude

MCP サーバーとして

1. グローバルにインストールします：

npm install -g @archimdescrypto/excel-reader

2. MCP 設定ファイル（通常は ~/.config/claude/settings.json または同等のファイル）に追加します：

{
  "mcpServers": {
    "excel-reader": {
      "command": "excel-reader",
      "env": {}
    }
  }
}

開発環境向け

1. リポジトリをクローンします：

git clone https://github.com/ArchimdesCrypto/mcp-excel-reader.git
cd mcp-excel-reader

2. 依存関係をインストールします：

npm install

3. プロジェクトをビルドします：

npm run build

使い方

使い方

Excel Reader は、以下のパラメーターを持つ単一のツール read_excel を提供します。

interface ReadExcelArgs {
  filePath: string;      // Path to Excel file
  sheetName?: string;    // Optional sheet name (defaults to first sheet)
  startRow?: number;     // Optional starting row for pagination
  maxRows?: number;      // Optional maximum rows to read
}

// Response format
interface ExcelResponse {
  fileName: string;
  totalSheets: number;
  currentSheet: {
    name: string;
    totalRows: number;
    totalColumns: number;
    chunk: {
      rowStart: number;
      rowEnd: number;
      columns: string[];
      data: Record<string, any>[];
    };
    hasMore: boolean;
    nextChunk?: {
      rowStart: number;
      columns: string[];
    };
  };
}

基本的な使い方

Claude またはその他の MCP 対応 AI で使用する場合：

Read the Excel file at path/to/file.xlsx

AI はこのツールを使ってファイルを読み取り、大きなファイルのチャンク分割を自動的に処理します。

機能

1. 自動チャンク分割

   • 大きなファイルを扱いやすいチャンクに自動で分割します
   • デフォルトのチャンクサイズは 100KB です
   • ページネーション用のメタデータを提供します

2. シートの選択

   • 名前を指定して特定のシートを読み取ります
   • 指定がない場合は、最初のシートがデフォルトで選択されます

3. 行のページネーション

   • startRow と maxRows を使って読み取る行を制御します
   • 続けて読み取るための次のチャンク情報を取得します

4. エラー処理

   • ファイルの存在と形式を検証します
   • 明確なエラーメッセージを表示します
   • 形式が正しくない Excel ファイルも適切に処理します

SheetJS の機能で拡張する

Excel Reader は SheetJS を基盤としており、その強力な機能を使って拡張できます：

利用可能な拡張機能

1. 数式の処理

   // Enable formula parsing
   const wb = XLSX.read(data, {
     cellFormula: true,
     cellNF: true
   });
   

2. セルの書式設定

   // Access cell styles and formatting
   const styles = Object.keys(worksheet)
     .filter(key => key[0] !== '!')
     .map(key => ({
       cell: key,
       style: worksheet[key].s
     }));
   

3. データ検証

   // Access data validation rules
   const validation = worksheet['!dataValidation'];
   

4. シートの機能

   • 結合セル：worksheet['!merges']
   • 非表示の行／列：worksheet['!rows']、worksheet['!cols']
   • シートの保護：worksheet['!protect']

その他の機能や詳しいドキュメントについては、SheetJS のドキュメントをご覧ください。

コントリビューション

1. リポジトリをフォークします
2. フィーチャーブランチを作成します（git checkout -b feature/amazing-feature）
3. 変更をコミットします（git commit -m 'Add some amazing feature'）
4. ブランチにプッシュします（git push origin feature/amazing-feature）
5. Pull Request を作成します

ライセンス

このプロジェクトは MIT License の下でライセンスされています。詳細は LICENSE ファイルをご覧ください。

謝辞

• SheetJS を使用して構築されています
• Model Context Protocol エコシステムの一部です