convez.ai
MCP ServerIntegração & APIsIntermediário
lubo3395

MCP XLSX Server

lubo3395/mcp-xlsx-server

Integração completa para manipular arquivos Excel via Claude

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP para leitura e escrita de arquivos Excel usando SheetJS. Fornece ferramentas para listar sheets, ler dados em JSON ou array, criar arquivos, adicionar sheets e atualizar células específicas.

Instalação

$npx convez-ai lubo3395/mcp-xlsx-server

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Ler dados de planilhas Excel para processamento automático
  • Criar e atualizar arquivos Excel programaticamente
  • Automatizar conversão de dados entre Excel e JSON
  • Integrar análise de dados em workflows com Claude

Veredito

Ferramenta sólida e bem documentada para operações Excel em contexto de MCP. Suporta os principais IDEs (Claude Code, VS Code, Cursor) e oferece flexibilidade nas formatações de dados. Recomendada para automações que envolvam planilhas.

README

A tradução para o português deste README ainda está na fila.

mcp-xlsx-server

基于 SheetJS (xlsx) 的 Excel 文件读写 MCP 服务。

功能

提供 5 个 MCP 工具:

工具功能
xlsx_list_sheets列出 xlsx 文件中所有 sheet 名称和行列数
xlsx_read读取指定 sheet 数据,支持 JSON/二维数组格式和范围选择
xlsx_create从 JSON 数据创建新的 xlsx 文件
xlsx_add_sheet向已有 xlsx 文件添加新 sheet
xlsx_update_cells更新指定单元格值

安装

npm install -g mcp-xlsx-server

或直接运行:

npx mcp-xlsx-server

配置

在 Claude Code 中

编辑 claude.json,使用 mcpServers 字段:

{
  "mcpServers": {
    "xlsx": {
      "command": "npx",
      "args": ["mcp-xlsx-server"]
    }
  }
}

在 VS Code (GitHub Copilot) 中

编辑 .vscode/mcp.json 或全局 mcp.json,使用 servers 字段(不是 mcpServers):

{
  "servers": {
    "xlsx": {
      "type": "stdio",
      "command": "npx",
      "args": ["mcp-xlsx-server"]
    }
  }
}

文件位置:

  • 工作区级别: .vscode/mcp.json
  • 全局: %APPDATA%\Code\User\mcp.json

在 Cline / Roo Code (VS Code 扩展) 中

编辑 cline.json 或 mcp.json,使用 mcpServers 字段:

{
  "mcpServers": {
    "xlsx": {
      "command": "npx",
      "args": ["-y", "mcp-xlsx-server"]
    }
  }
}

在 Cursor 中

编辑 .cursor/mcp.json,使用 mcpServers 字段:

{
  "mcpServers": {
    "xlsx": {
      "command": "npx",
      "args": ["mcp-xlsx-server"]
    }
  }
}

工具详解

xlsx_list_sheets

列出 xlsx 文件中所有 sheet。

参数:

  • file_path (string, 必填): xlsx 文件路径

xlsx_read

读取指定 sheet 的数据。

参数:

  • file_path (string, 必填): xlsx 文件路径
  • sheet (string|number, 必填): sheet 名称或索引 (从 0 开始)
  • format (string, 默认 "json"): "json" 返回对象数组, "array" 返回二维数组
  • range (string, 可选): 单元格范围,如 "A1:C10"

xlsx_create

从 JSON 数据创建新的 xlsx 文件。

参数:

  • file_path (string, 必填): 输出路径
  • data (string, 必填): JSON 数据字符串
  • sheet_name (string, 默认 "Sheet1"): sheet 名称
  • overwrite (boolean, 默认 false): 是否覆盖已有文件

xlsx_add_sheet

向已有 xlsx 文件添加新 sheet。

参数:

  • file_path (string, 必填): 已存在的 xlsx 文件路径
  • data (string, 必填): JSON 数据字符串
  • sheet_name (string, 必填): 新 sheet 名称

xlsx_update_cells

更新指定单元格。

参数:

  • file_path (string, 必填): xlsx 文件路径
  • sheet (string|number, 必填): sheet 名称或索引
  • cells (string, 必填): JSON 对象,如 {"A1": "值", "B2": 123}

本地开发

# 克隆仓库
git clone https://github.com/lubo3395/mcp-xlsx-server.git
cd mcp-xlsx-server

# 安装依赖
npm install

# 开发模式 (热重载)
npm run dev

# 构建
npm run build

# 运行
npm start

# MCP Inspector 测试
npx @modelcontextprotocol/inspector node dist/index.js

License

MIT

Ver o original no GitHub

Bom para

Relacionados