voyager-inc/excel-vision-mcp
Developer toolsЭта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал
MCP server that lets AI agents SEE embedded images inside Excel files — full text + image extraction for .xlsx/.xlsm
Обзор
Other Excel MCP servers return cell values and silently drop every embedded image, so the flowchart your spec depends on never reaches the model. Excel Vision MCP returns them as native ImageContent your AI can actually look at — alongside the text, formatting, and formulas. 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: Same file. One agent sees a table of strings; the other sees what the author actually meant. Most Excel MCP servers only read cell values. This server uses a : 1. (primary) — Maps each image to its exact cell location using openpyxl-image-loader 2.
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"]
}
}
}