Excel Reader MCP

🚀 MCP Excel 文件閱讀器

MCP Excel 文件閱讀器是一個基於 Model Context Protocol (MCP) 的服務器工具，它能夠讀取 Excel 文件，並自動進行分塊和分頁處理。該工具使用 SheetJS 和 TypeScript 構建，可高效處理大型 Excel 文件，通過自動將其分解為易於管理的分塊，提升處理效率。

🚀 快速開始

MCP Excel 文件閱讀器可助力您高效處理 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 生態系統的一部分