Excel Reader MCP

🚀 MCP Excel ファイルリーダー

このツールは、Model Context Protocol (MCP) サーバーで、Excel ファイルを読み取り、自動的にチャンク分割とページングを行います。SheetJS と TypeScript を使用して構築されており、大規模な Excel ファイルを自動的に管理しやすいチャンクに分割することで、効率的な処理を支援します。

✨ 主な機能

• 📊 .xlsx および .xls 形式の Excel ファイルの読み取りをサポート
• 🔄 大きなファイルを自動的にチャンク分割
• 📑 シート選択と行のページングをサポート
• 📅 日付形式を正しく処理
• ⚡ 大規模ファイルに対応するように最適化
• 🛡️ 強力なエラー処理と検証

📦 インストール

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/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 start

💻 使用例

基本的な使用法

インターフェース定義

リクエストパラメータ

interface ReadExcelRequest {
  file: File; // 読み取る Excel ファイル
  sheetName?: string; // オプション：読み取るシート名
  headers?: boolean; // オプション：ヘッダー行を含むかどうか
}

レスポンス形式

interface ReadExcelResponse {
  data: any[][]; // データを含む二次元配列
  headers?: string[]; // オプション：ヘッダー行を含む配列
  error?: string; // オプション：エラーメッセージ（ある場合）
}

コード例

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

const file = document.getElementById('fileInput') as HTMLInputElement;
const result = await readExcel({
  file: file.files[0],
  headers: true,
});

if (result.error) {
  console.error('ファイルの読み取り中にエラーが発生しました:', result.error);
} else {
  console.log('データが正常に読み取られました:', result.data);
  if (result.headers) {
    console.log('ヘッダー行:', result.headers);
  }
}

📚 ドキュメント

MCP Excel Reader は強力な 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. プルリクエストを送信します。

📄 ライセンス

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

謝辞

• 強力な SheetJS を使用して構築されています。
• Model Context Protocol エコシステムの一部として提供されています。