MCP Server
excel-formula-helper
maoxin1234/excel-formula-helper
48
InicialPluginScore · de 0 a 100Excel/WPS 公式助手:模板库+AI生成的网页工具,以及可读写xlsx的MCP服务器
Instalação
$
npx convez-ai maoxin1234/excel-formula-helper1 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
0Forks
0Acompanhando
0Saúde
42%Último commit
há 5 mesesVersão
—Issues abertas
0Contribuidores
1README
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-server | Python MCP 服务器 | 给 AI 客户端(Claude Desktop / Cursor 等)调用,直接读写 .xlsx |
截图
| 模板库 | 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)需较新版本,旧版请用模板里给出的兼容写法。


