How negokaz/excel-mcp-server works
Excel MCP Server exposes workbook operations as MCP tools over stdio. An MCP client invokes the server, which registers tool handlers; handlers validate requests, access workbook/sheet operations, and return text, structured metadata, or images. The documented capabilities include sheet description and reading, writing values and formulas, sheet creation and copying, tables, formatting, and Windows screen capture. The source excerpts show tool-to-workbook calls and paging/rendering use; backend implementation details are grouped at the supported package path because they were not fully sampled.
Main entry points: server.go MCP server · excel Workbook operations · excel_read_sheet.go Read sheet · excel_describe_sheets.go Describe sheets
Components 16
MCP runtime
- Server entry
cmd/excel-mcp-server/main.go - MCP server
internal/server/server.go
Workbook tools
- Describe sheets
internal/tools/excel_describe_sheets.go - Read sheet
internal/tools/excel_read_sheet.go - Write sheet
internal/tools/excel_write_to_sheet.go - Create table
internal/tools/excel_create_table.go - Copy sheet
internal/tools/excel_copy_sheet.go - Format range
internal/tools/excel_format_range.go - Screen capture
internal/tools/excel_screen_capture.go
Excel access
- Workbook operations
internal/excel - Range paging
internal/excel/pagination.go - Windows Excel access
internal/excel/excel_ole.go
Response support
- HTML rendering
internal/tools/common.go - Tool errors
internal/mcp/error.go
Other components
- MCP client
- Excel workbook
Connections 23
- MCP client → MCP server: calls tools
internal/server/server.go - Server entry → MCP server: starts
cmd/excel-mcp-server/main.go - MCP server → Describe sheets: registers
internal/server/server.go - MCP server → Read sheet: registers
internal/server/server.go - MCP server → Write sheet: registers
internal/server/server.go - MCP server → Create table: registers
internal/server/server.go - MCP server → Copy sheet: registers
internal/server/server.go - MCP server → Format range: registers
internal/server/server.go - MCP server → Screen capture: registers on Windows
internal/server/server.go - Describe sheets → Workbook operations: reads workbook
internal/tools/excel_describe_sheets.go - Read sheet → Workbook operations: reads sheet
internal/tools/excel_read_sheet.go - Write sheet → Workbook operations: writes sheet
internal/tools/excel_write_to_sheet.go - Create table → Workbook operations: creates table
internal/tools/excel_create_table.go - Copy sheet → Workbook operations: copies sheet
internal/tools/excel_copy_sheet.go - Format range → Workbook operations: sets styles
internal/tools/excel_format_range.go - Screen capture → Windows Excel access: captures range
internal/tools/excel_screen_capture.go - Read sheet → Range paging: pages ranges
internal/tools/excel_read_sheet.go - Describe sheets → Range paging: lists page ranges
internal/tools/excel_describe_sheets.go - Screen capture → Range paging: pages ranges
internal/tools/excel_screen_capture.go - Read sheet → HTML rendering: renders results
internal/tools/excel_read_sheet.go - Write sheet → HTML rendering: renders results
internal/tools/excel_write_to_sheet.go - Workbook operations → Excel workbook: reads and writes
- Windows Excel access → Excel workbook: edits workbook