Excel Reader

🚀 MCP Excel 讀取器

MCP Excel 讀取器是一個基於模型上下文協議 (MCP) 的服務器，可用於讀取 Excel 文件，並自動進行分塊和分頁處理。它藉助 SheetJS 和 TypeScript 構建，能幫助您高效處理大型 Excel 文件，通過自動將其分解為易於管理的分塊。

🚀 快速開始

MCP Excel 讀取器能高效處理 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) 生態系統的一部分