Excel Reader

🚀 MCP Excel 読み取り器

モデルコンテキストプロトコル (MCP) に基づくサーバーで、Excel ファイルを読み取り、自動的にチャンク分割とページング処理を行います。SheetJS と TypeScript で構築されたこのツールは、大型の Excel ファイルを自動的に管理しやすいチャンクに分割することで、効率的な処理をサポートします。

🚀 クイックスタート

このツールは、モデルコンテキストプロトコル (MCP) を利用して、Excel ファイルの読み取りとチャンク分割、ページング処理を自動化します。SheetJS と TypeScript で構築されており、大型の Excel ファイルを効率的に処理できます。

✨ 主な機能

• 📊 Excel ファイル（.xlsx、.xls）の読み取りと自動的なサイズ制限設定をサポート
• 🔄 大規模データセットの自動チャンク分割処理
• 📑 ワークシートの選択と行のページングをサポート
• 📅 日付の正しい処理
• ⚡ 大型ファイルの処理に最適化
• 🛡️ エラー処理と検証

📦 インストール

Smithery を使用したインストール

Smithery を通じて、Excel Reader for Claude Desktop を自動的にインストールします。

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

MCP サーバーとしてのインストール

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

npm install -g @archimdescrypto/excel-reader

2. あなたの MCP 設定ファイル（通常は ~/.config/mcp/config.json）に追加します。

{
  "servers": {
    "excel-reader": {
      "url": "http://localhost:3000"
    }
  }
}

💻 使用例

インターフェース定義

リクエストパラメータ

interface ReadExcelArgs {
  file: string; // Excel ファイルのパスまたは URL
  sheet?: number | string; // 読み取るワークシートの番号または名前（オプション）
  headers?: boolean; // ヘッダー行を含めるかどうか（デフォルトは true）
}

レスポンス形式

interface ExcelResponse {
  data: any[]; // 解析後のデータ配列
  error?: string; // エラーメッセージ（エラーが発生した場合に返されます）
}

基本的な使用法

import { readExcel } from '@archimdescrypto/excel-reader';

async function main() {
  try {
    const result = await readExcel({
      file: 'path/to/file.xlsx',
      sheet: 0, // 最初のワークシートを指定
      headers: true // ヘッダー行を含める
    });
    
    if (result.error) {
      console.error('ファイルの読み取り中にエラーが発生しました:', result.error);
    } else {
      console.log('データが正常に読み取られました:', result.data);
    }
  } catch (error) {
    console.error('エラーが発生しました:', error);
  }
}

main();

📚 ドキュメント

機能拡張

SheetJS が提供する追加機能を使用することで、以下のことができます。

• 結合セルの処理
• データ形式の変換（日付、数字など）
• フィルターとソートの適用
• ワークシートの保護状態の操作
• ワークブック内の複数のワークシートの管理

詳細なドキュメントについては、SheetJS ドキュメント を参照してください。

貢献方法

1. リポジトリをフォークします。
2. 機能ブランチを作成します (git checkout -b feature/amazing-feature)。
3. 変更をコミットします (git commit -m '素晴らしい機能を追加')。
4. ブランチにプッシュします (git push origin feature/amazing-feature)。
5. Pull Request を開きます。

📄 ライセンス

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

謝辞

• SheetJS を使用して構築されています。
• モデルコンテキストプロトコル (MCP) エコシステムの一部として提供されています。