Excel Reader MCP

🚀 MCP Excel 文件阅读器

MCP Excel 文件阅读器是一个基于 Model Context Protocol (MCP) 的服务器工具，借助 SheetJS 和 TypeScript 构建。它能高效读取 Excel 文件，自动进行分块和分页处理，帮助您轻松应对大型 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 生态系统的一部分