convez.ai
MCP Server
maoxin1234

excel-formula-helper

maoxin1234/excel-formula-helper

Ver no GitHub
InicialPluginScore · de 0 a 100

Excel/WPS 公式助手:模板库+AI生成的网页工具,以及可读写xlsx的MCP服务器

Instalação

$npx convez-ai maoxin1234/excel-formula-helper

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
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

README

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

Excel / WPS 公式助手 · Formula Helper

一套帮你在 Microsoft Excel 或 WPS 里快速写出复杂公式并落地到表格的工具,灵感来自微软 Excel 电竞比赛(FMWC / Excel World Championship)。

包含两部分,可独立使用,也可搭配:

工具形态给谁用
公式助手单文件网页 公式助手.html人手动用:选任务、填参数、一键复制公式
excel-mcp-serverPython MCP 服务器给 AI 客户端(Claude Desktop / Cursor 等)调用,直接读写 .xlsx

截图

模板库AI 生成报错诊断
模板库AI 生成报错诊断

在线体验(GitHub Pages):https://maoxin1234.github.io/excel-formula-helper/


一、公式助手(公式助手.html)

双击即用,无需安装,离线可用,微软 Excel 与 WPS 通用。

功能

  • 模板库:选任务 → 填参数 → 实时生成公式 → 一键复制
    • 查找匹配:VLOOKUP / XLOOKUP / INDEX+MATCH
    • 条件汇总:SUMIFS / COUNTIFS / AVERAGEIFS
    • 文本处理:合并、截取、按符号分段、清洗去空格
    • 日期时间:工龄/年龄、月末推算、工作日推算
    • 排名统计:RANK、去重计数
    • 动态数组(新版):FILTER / UNIQUE / SORT / LET / LAMBDA、筛选+排序+取前 N
    • 数据透视替代:二维交叉汇总、动态透视、占比 / 累计占比
    • 逻辑防错:IFS 多区间分级、IFERROR 防错包裹
  • AI 生成:用自然语言描述任务,调用大模型生成公式。支持多家厂商: Anthropic、OpenAI、Google Gemini、DeepSeek、通义千问、Kimi、智谱 GLM,以及任意 OpenAI 兼容端点(含本地 Ollama)。
  • 报错诊断面板:#N/A #VALUE! #REF! #DIV/0! #NAME? #SPILL! #NUM! 的成因、逐项排查清单与修复方案。
  • 中文环境适配:一键把公式参数分隔符在 , / ; 间切换。

AI 功能说明

  • API Key 仅保存在本机浏览器 localStorage,不上传任何第三方;请求由浏览器直接发往所选厂商。
  • 浏览器直连可能遇到 CORS 跨域限制。国内网络建议优先选 DeepSeek / Kimi(对浏览器较友好),或用支持跨域的中转地址(“自定义”选项填 Base URL)。

二、excel-mcp-server(excel_mcp_server.py)

一个 MCP 服务器,让 AI 客户端直接读写本地 Excel 文件——读结构、读区域、写公式、批量铺数据、套模板、查报错。

依赖

pip install "mcp[cli]" openpyxl
# 可选:把公式重算成真实值,需要本机安装 LibreOffice

工具列表

工具作用
list_sheets列出工作表及尺寸
read_range读区域(值或公式原文)
write_value写单个值
write_rows一次写入整片二维数据(表头+数据)
write_formula写公式,支持向下智能填充(行号自增、$ 锁定、不误伤工作表名)
create_workbook新建工作簿
recalculate调 LibreOffice 把公式重算为真实值
list_templates / build_from_template内置公式模板库
diagnose_error报错代码诊断
flush把缓存中未保存的修改强制落盘

接入方式

Claude Desktop — 编辑 claude_desktop_config.json:

{
  "mcpServers": {
    "excel-helper": {
      "command": "python",
      "args": ["/绝对路径/excel_mcp_server.py"],
      "env": { "EXCEL_MCP_ROOT": "/允许访问的根目录" }
    }
  }
}

Claude Code:

claude mcp add excel-helper python "/绝对路径/excel_mcp_server.py"

接好后,直接用自然语言即可,例如:

“看一下 销售.xlsx 的结构,在 D 列填每行所属部门当月金额合计,填到第 200 行。”

安全

  • 默认仅允许访问用户主目录;用环境变量 EXCEL_MCP_ROOT 可收紧到指定文件夹。
  • openpyxl 只写公式不计算值——文件需用 Excel / WPS 打开(或调用 recalculate)后才显示结果。

兼容性

  • Microsoft Excel 365 / 2019 及以上,WPS 表格较新版本。
  • 部分动态数组函数(FILTER / UNIQUE / SORT / LET / LAMBDA / XLOOKUP / TAKE)需较新版本,旧版请用模板里给出的兼容写法。

许可证

MIT

Ver o original no GitHub

Bom para

Relacionados