- STARS⭐ 3.9k
- FORKS424
- LICENSEMIT
- BYharis-musa
- LANGPython
- PRICINGUNKNOWN
Excel MCP Server 是什么
一、什么是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）
配置 MCP 客户端：
启动后支持 excel_describe_sheets、excel_read_sheet、excel_write_to_sheet、excel_create_table、excel_copy_sheet、excel_format_range 等工具。
5.2 Python 版本（haris‑musa）
启动服务：
适配 MCP 客户端：
工具支持读取、写入、格式化、生成图表与透视表，功能丰富。
六、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 生态的重要桥梁。
