
MCP服务器允许AI代理看到Excel文件中的嵌入图像——全文+.xlsx/.xlsm的图像提取
概览
其他 Excel MCP 服务器会返回单元格值,并悄无声息地丢弃所有嵌入图像,因此你依赖的流程图永远无法到达模型。Excel Vision MCP 会将这些图像作为 AI 实际可查看的原生图像内容返回——与文本、格式和公式并列。 请你的助理审查一份需求规格。一半的意义存在于截图、流程图和粘贴在单元格中的注释图中——而每个Excel的MCP服务器只会给模型文本。答案自信且不完整,因为模型从未知道这些图片的存在。 同样的盲点也适用于作者留下的其他信号: 同一个文件。一个代理看到的是字符串表;另一个代理看到的是作者的实际意思。 大多数 Excel MCP 服务器只读取单元格值。该服务器使用 : 1. (主) — 使用openpyxl-image-loader将每幅图像精确映射到其单元格位置 2.
概述(AI 翻译)
你的人工智能读取电子表格。它看不到B12单元的图表。
**这解决了这个问题。**其他Excel MCP服务器会返回单元格值,并悄无声息地丢弃所有嵌入的图像,所以你所依赖的流程图永远无法到达模型。Excel Vision MCP会以AI实际能查看的原生[[T0]返回这些图像——与文本、格式和公式并列。
安装 ·工具 ·配置 ·工作原理 ·常见问题解答
🤔 问题
请你的助理审查一份需求规格。一半的意义存在于截图、流程图和粘贴在单元格中的注释图中——而每个Excel的MCP服务器只会给模型文本。答案自信且不完整,因为模型从未知道这些图片的存在。
同样的盲点也适用于作者留下的其他信号:
| 作者所做的事情 | 其他MCP服务器报告的内容 | Excel Vision MCP报告的内容 |
|---|---|---|
在B12中粘贴了流程图。无物 |
图像本身,映射到B12 |
|
| 被取消的行划分 | Legacy export |
Legacy export [S] — 划线 |
| 标记了一行供复习 | Pending |
Pending [HL:yellow] |
本页由 AI 翻译,技术细节请以原文为准。
README
以下为原文 README 节选,完整内容请查看原文。
🤔 The Problem
Ask your assistant to review a requirements spec. Half the meaning lives in screenshots, flowcharts, and annotated diagrams pasted into cells — and every Excel MCP server hands the model text only. The answer comes back confident and incomplete, because the model never knew the pictures existed.
The same blind spot applies to the other signals authors leave behind:
| What the author did | What other MCP servers report | What Excel Vision MCP reports |
|---|---|---|
Pasted a flowchart in B12 |
nothing | The image itself, mapped to B12 |
| Struck through a cancelled row | Legacy export |
Legacy export [S] — strikethrough |
| Highlighted a row for review | Pending |
Pending [HL:yellow] |
| Hid an internal-cost column | The hidden values, as if normal | Skipped — unless a formula needs it |
Same file. One agent sees a table of strings; the other sees what the author actually meant.
✨ Key Features
| Feature | Description |
|---|---|
| 🖼️ Image Extraction | Extracts all embedded images with cell-position mapping |
| 📄 Full Content Reading | Text + images in a single call — nothing is missed |
| 🏷️ Format-Aware Reading | Reports bold, strikethrough, highlights and font colors so agents read intent, not just text |
| 🙈 Hidden-Content Aware | Skips hidden rows/columns by default, keeping those formulas depend on |
| ✍️ Write Support | Create workbooks, update cells, write formulas, insert images |
| 🎨 Formatting | Colors, fonts, borders, alignment, number formats, auto-fit columns |
| 🛡️ Atomic Saves | A failed write can never corrupt your original file |
| 📊 Smart Pagination | Handles massive spreadsheets without blowing up context |
| 🔍 Text Search | Find content across all sheets instantly |
| 🔒 100% Local | Your files never leave your machine |
| ⚡ Fast | 16MB file with 40 images processed in ~4 seconds |
| 🖥️ Cross-Platform | macOS, Linux, Windows |
安装
docker run --rm -i -v /path/to/spreadsheets:/data excel-vision-mcp配置
{
"mcpServers": {
"excel-reader": {
"command": "docker",
"args": ["run", "--rm", "-i", "-v", "/path/to/spreadsheets:/data", "excel-vision-mcp"]
}
}
}