excel-poi-mcp

Excel MCP 服务（stdio），用于替换 @itkmoon/excel-mcp。 底层：Java 17 + Solon（CMD 用法）+ Apache POI 5.2.5 + Snack3，支持 .xls / .xlsx。

工具

| 工具 | 说明 | |------|------| | read_excel | 读取 Excel 内容：值、公式、合并区域、格式（字体/颜色/边框/填充/对齐/数字格式） | | write_excel | 写入数据：新建/覆盖/追加/更新，支持表头 | | format_excel | 格式化单元格：字体、背景、边框、对齐、数字格式 | | manage_sheets | 工作表管理：list / create / delete / rename / copy / move | | get_file_info | 文件信息：大小、修改时间、工作表列表 |

安装 / 使用（npx）

{
  "command": "npx",
  "args": ["excel-poi-mcp"],
  "env": {
    "JAVA_HOME": "D:\\usr\\java\\jdk-17.0.19x64"
  }
}

本地开发调试可绕过 npx 直接运行：

node bin/excel-poi-mcp.js
# 或
java -jar lib/excel-poi-mcp.jar

构建

build.bat

等价命令：mvn clean package -DskipTests，产物复制到 lib/excel-poi-mcp.jar。

协议约定

• 每行一条 JSON-RPC 消息（UTF-8，MCP stdio 协议）。
• stdout 只输出 JSON-RPC 响应；所有日志走 stderr。
• stdin 读到 EOF 后进程自动退出（客户端断开即结束）。
• 不依赖 solon-ai-mcp 的 reactor 通道，JSON-RPC 由 StdioMcpServer 手动实现，更稳定、启动更快（约 150ms）。

源码结构

src/main/java/com/sks/excel/mcp/
  App.java                 入口（Solon 启动 + stdio 主循环）
  server/StdioMcpServer.java   MCP JSON-RPC 协议处理
  server/ExcelReader.java      Excel 读取（POI）
  server/ExcelWriter.java      Excel 写入/格式化/工作表管理（POI）
  util/CellRange.java          单元格范围解析
  util/ColorUtil.java          颜色解析/转换
  util/ExcelIO.java            工作簿打开/保存