@tanskong/office-mcp

Office MCP - Excel实时办公助手

通过MCP协议让AI助手(Trae)操作Excel文件，实现智能办公自动化。

功能特性

• ✅ 实时操作：Excel保持打开状态，边操作边查看
• ✅ 批量处理：支持批量读写、格式设置、公式操作
• ✅ 图片识别：提取Excel中的图片，支持多模态识别
• ✅ 工作表管理：增删改查工作表
• ✅ 表格美化：自动格式化、颜色设置、对齐方式
• ✅ 许可证认证：密钥激活，绑定设备

快速开始

方式一：使用安装器（推荐）

• 下载 智能办公助手v6.0.exe
• 双击运行，输入 License Key
• 完成安装，重启 Trae
• 右键桌面"智能办公助手"文件夹 → 使用 Trae 打开
• 开始使用

方式二：手动安装

1. 安装依赖

pip install fastmcp pywin32

2. 激活 License

npm cache clean --force
set OFFICE_MCP_LICENSE=你的KEY && npx -y @tanskong/office-mcp@latest activate

看到 [OK] Activation Successful! 即表示成功。

3. 配置 Trae

在项目文件夹中创建 .trae/mcp.json：

{
  "mcpServers": {
    "office-mcp": {
      "command": "npx",
      "args": ["-y", "@tanskong/office-mcp@latest"],
      "env": {
        "OFFICE_MCP_LICENSE": "你的KEY"
      }
    }
  }
}

工具列表（23个）

分类	工具	功能
工作簿生命周期	workbook_file	创建/打开工作簿
	save_workbook	保存工作簿
	export_to_pdf	导出PDF
工作表管理	sheet_manage	添加/删除工作表
	copy_sheet	复制工作表
数据读取	read_cell	读取单元格
	get_excel_data	获取区域数据
	get_selection	获取当前选择
数据写入	write_data	写入数据（支持cells/rows模式，自动识别）
格式操作	set_format	设置区域格式（背景色、字体色、粗体、字号、对齐）
	get_format	获取单元格/区域格式
	auto_format_table	自动美化表格
	set_dimension	设置行高/列宽（支持批量）
公式	create_formula	创建公式（支持单个/批量）
	fill_formula	填充公式（向下/向右）
结构修改	modify_rows_columns	插入/删除行列
	merge_cells	合并/取消合并单元格
	create_table	创建结构化表格
图片与导出	list_sheet_images	列出图片
	extract_images_from_excel	提取图片
	delete_sheet_image	删除图片
	screen_capture	截图功能
信息查询	get_workbook_info	获取工作簿信息

高效使用示例

批量设置格式（一次调用替代多次）

set_format("Sheet1", "A1:D1", 
    color="blue",           # 背景色
    font_color="white",     # 字体色
    bold=True,              # 粗体
    font_size=12,           # 字号
    horizontal="center",    # 水平对齐
    vertical="center"       # 垂直对齐
)

批量写入数据

# rows模式 - 写入多行
data = [["姓名", "年龄"], ["张三", 25], ["李四", 30]]
write_data("Sheet1", data, start_cell="A1", mode="rows")

# cells模式 - 写入特定单元格
cells_data = {"A1": "标题", "B1": 100, "C1": "完成"}
write_data("Sheet1", cells_data, mode="cells")

# 自动识别模式
write_data("Sheet1", {"A1": "标题", "B1": 100})  # 自动识别为cells模式
write_data("Sheet1", [["标题", "数值"], ["数据1", 100]], "A1")  # 自动识别为rows模式

合并/取消合并单元格

merge_cells("Sheet1", "A1:D1", "merge")     # 合并
merge_cells("Sheet1", "A1:D1", "unmerge")   # 取消合并

公式创建与填充

# 创建单个公式
create_formula("Sheet1", "E2", "=C2*D2")

# 批量创建公式
create_formula("Sheet1", {"E2": "=C2*D2", "E3": "=C3*D3", "E4": "=C4*D4"})

# 向下填充公式
fill_formula("Sheet1", "E2", 100, "down")   # 从E2填充到E100

工作簿操作

# 创建工作簿
workbook_file("create", "C:/test.xlsx")

# 打开工作簿
workbook_file("open", "C:/test.xlsx")

# 添加工作表
sheet_manage("add", "Sheet2")

# 删除工作表
sheet_manage("delete", "Sheet2")

开发

# 安装依赖
npm install

# 本地调试
npm run dev

# 发布
npm version patch
npm publish

版本历史

版本	日期	更新内容
1.0.83	2026-05-30	工具合并优化至21个：set_range_*→set_format, batch_write_cells/batch_write_rows→write_data, create_formula/batch_create_formulas→create_formula, fill_formula_down→fill_formula, get_cell_format/get_range_format→get_format
1.0.82	2026-05-30	工具合并优化版
1.0.81	2026-05-29	安装器重构为项目级配置
1.0.80	2026-05-28	修复 Unicode 编码错误
1.0.78	2026-05-28	工具合并优化，42→37个

许可证

MIT