VI

voyager-inc/excel-vision-mcp

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

20 stars 2 forks 质量 81 趋势 14MIT

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
在 GitHub 查看完整 README

安装

docker run --rm -i -v /path/to/spreadsheets:/data excel-vision-mcp
新手?先看 mcpskill.org 教程 →

配置

{ "mcpServers": { "excel-reader": { "command": "docker", "args": ["run", "--rm", "-i", "-v", "/path/to/spreadsheets:/data", "excel-vision-mcp"] } } }