一、什么是Excel MCP Server?
Excel MCP Server是一个基于Model Context Protocol (MCP) 的工具服务,允许AI模型无缝读取、编辑和创建 Excel工作簿。提供通用接口支持 .xlsx/.xlsm/.xltx/.xltm 文件格式,无需安装 Microsoft Excel 即可运行。
该项目有多个实现版本,包括JavaScript(由 negokaz 维护)、Python(由 haris‑musa 维护)等,用户可根据平台选择合适版本。其核心功能覆盖文本、公式读写,样式与图表管理,支持流式与标准传输通信。
二、核心功能与技术亮点
2.1 Excel文件读写与结构管理
读取工作簿信息(sheet 名称、表维度等);
批量读取单元格文本、公式、样式;
创建或复制工作表,支持 paging 分页读取大量单元格。
2.2 公式与样式处理
支持写入公式(值以
=开头),自动计算;设置字体、边框、单元格合并、对齐等样式;
创建数据表格(Excel tables)、生成图表与透视表等。
2.3 多模式与跨平台通信
JS版本 支持 Stdio、SSE(已弃用)、HTTP 流;
Python实现 支持 Stdio 与 SSE;
Windows 版本支持 Excel 界面截图功能和 live editing。
2.4 MCP Agent 集成
Excel MCP Server 可作为一个工具服务器接入基于 MCP 的 Agent 系统(如 Claude、LangDB、Cursor),标准 JSON-RPC 接口调用方式统一模型上下文。
三、版本比较与生态支持
| 实现 | 语言 | 特性亮点 | 著名作者 | 星标 |
|---|---|---|---|---|
| negokaz | TypeScript | NPM 包、公式读写、样式表、截图(Win) | Kazuki Negoro | 391 |
| haris‑musa | Python | 图表、透视表、验证、HTTP/SSE、AI 集成 | Haris Musa | 1.7k |
| yzfly | Python | 轻量版、自定义交互 | yzfly | 60 |
Python 实现具备丰富 Excel 功能与社区支持,JavaScript 版本更适合 Node.js 环境集成。
四、典型使用场景与价值
4.1 AI表格自动化:
Agent 可通过自然语言指令批量更新表格数据、应用公式与样式,替代手动操作。
4.2 数据分析与报表生成:
可读写带有图表/透视表的文件,适合智能报表 Agent 自动编制与更新 Excel 报表。
4.3 Agent工具链集成:
MCP可处理表格操作、模型调用与界面反馈合入工作流,实现一体化自动化 Agent。
4.4 跨平台部署:
无需 Excel 安装,也可支持服务器端批处理与移动端集成,适合云端与本地环境部署。
五、安装与入门指南
5.1 JavaScript 版本(negokaz)
npm install @negokaz/excel-mcp-server
配置 MCP 客户端:
{ "mcpServers": { "excel": { "command": "npx", "args": ["--yes","@negokaz/excel-mcp-server"], "env": {"EXCEL_MCP_PAGING_CELLS_LIMIT":"4000"} } } }
启动后支持 excel_describe_sheets、excel_read_sheet、excel_write_to_sheet、excel_create_table、excel_copy_sheet、excel_format_range 等工具。
5.2 Python 版本(haris‑musa)
git clone https://github.com/haris-musa/excel-mcp-server.git cd excel-mcp-server pip install -e .
启动服务:
excel-mcp-server stdio # 或 excel-mcp-server sse --host 0.0.0.0 --port 8000
适配 MCP 客户端:
{ "mcpServers": { "excel": {"url":"http://localhost:8000/sse","env":{"EXCEL_FILES_PATH":"/data/excels"}} } }
工具支持读取、写入、格式化、生成图表与透视表,功能丰富。
六、FAQ 常见问题
Q1:是否需要安装 Excel?
不需要。Python 版本使用 openpyxl 操作;JS 版本不依赖 Office。仅 Windows 支持截图功能需 Excel 安装。
Q2:支持哪种文件格式?
支持 .xlsx, .xlsm, .xltx, .xltm 等格式。
Q3:如何设置分页读取?
通过环境变量 EXCEL_MCP_PAGING_CELLS_LIMIT 控制最大批量单元格数。
Q4:能否生成图表与透视表?
Python 版本支持图表、透视表等高级 Excel 功能;JS 版本主要针对表格数据与样式操作。
Q5:如何部署到 Agent 平台?
可接入 Claude Desktop、Cursor、LangDB 等,标准 MCP JSON-RPC 通信让 Agent 调用 Excel 工具。
Q6:安全性与多用户共享?
通信通过本地或受控 HTTP。建议部署在内部私有网络并控制目录权限,对于多人使用可结合 API 网关管理授权。
Q7:支持异步与数据流吗?
HTTP 版本支持 Stream 通信协议,可用于大数据量异步处理;JS 版本也支持类似实现。
Q8:有哪些开发文档?
各项目 GitHub README 和 TOOLS.md 提供详细说明,同时 LangDB、LobeHub 页面展示可视配置操作。
七、优势与局限对比
| 维度 | Excel MCP Server | 手写代码库(如 openpyxl) | 商业 SaaS 表格 API |
|---|---|---|---|
| AI Agent 接入 | ✅ 原生 MCP 协议,自动调用 excel 作为工具 | ❌ 需自编接口或包装 | ✖ 大多数不支持 |
| Excel 功能支持 | ✅ JS 可读写,Python 支持图表/透视表 | ✅ 功能齐全但需编码 | ✅ 封装接口,但需付费 |
| 部署环境 | ✅ 无需 Excel 安装支持远程部署 | ✅ 本地或云端任意部署 | ✅ SaaS 云服务 |
| 多协议支持 | ✅ stdio/SSE/HTTP 支持多 Agent 场景 | ✖ 单语言绑定 | ✅ HTTP API |
| 自动化能力 | ✅ 与 LLM 自动调用相容 | ✖ 需开发额外触发器 | ✅ 某些平台提供自动化 |
八、社区案例与用户反馈
LangDB 展示 Excel MCP Server 提供“一键部署与全链追踪”轻松集成 Agent。
在 GitHub Issue 中,有用户透露“用于自动生成报表、AI驱动数据校验及错误修正,大幅提高效率”。
Medium 上展示初学者使用此服务结合 GPT 实现多步骤自动化 Excel 操作流程。
九、使用建议与未来方向
为 Web 部署增加 API 鉴权与日志管理;
增加增强功能:如表格模板、智能填充助手等;
增强 Windows 实时截图,结合 OCR 实现视觉表格输入;
支持多人协同操作锁与版本管理;
建立社区插件生态,拓展更多 Office 家族文档支持。
十、总结
Excel MCP Server 是 AI 工具使用者实现 Excel 智能操作的关键服务骨架。它不仅解决了无 Office 环境的表格读写问题,也为构建 Agent 编排、自动报表、数据验证和可视分析提供了标准化接口。无论是模型调用、流程嵌入还是大规模部署,Excel MCP Server 都是连接表格世界与 AI 生态的重要桥梁。



