voyager-inc/excel-vision-mcp
Developer tools이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기
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"]
}
}
}