Excel Vba MCP

ExcelForge

基于 MCP 协议的 Excel 自动化工具服务。单一 Host 入口，通过 Profile / Bundle 按场景装配工具。

当前版本 v2.5.0 — 18 个能力域 · 101+ 个工具 · 14 个 Bundle · 12 个 Profile（含 5 个开发 Profile）。

安装

前置要求

第一步：安装 uv（如尚未安装）

pip install uv

第二步：克隆仓库

git clone 
cd ExcelForge

第三步：安装依赖

uv sync

依赖说明：uv sync 会自动从 pyproject.toml 安装以下依赖包： - pydantic >= 2.8 - PyYAML >= 6.0.1 - mcp >= 1.2.0 - pywin32 >= 306 (Windows) - psutil >= 5.9.0 - openpyxl >= 3.1.5

第四步：快速验证

# 查看可用 Profile
uv run python -m excelforge.gateway.host --config excel-mcp.yaml --list-profiles

# 查看可用 Bundle
uv run python -m excelforge.gateway.host --config excel-mcp.yaml --list-bundles

# 查看当前 Profile 的工具清单
uv run python -m excelforge.gateway.host --config excel-mcp.yaml --profile basic_edit --dump-tools

配置文件说明

本项目使用两个配置文件，一般不需要修改：

两个文件都使用相对路径，确保从项目根目录运行命令即可正常工作。

启动

uv run python -m excelforge.gateway.host --config excel-mcp.yaml --profile basic_edit

如何选择 Profile

Profile 决定暴露哪些工具，根据使用场景选择：

切换 Profile：修改 --profile 参数后重启服务。

选择 Profile

Profile 决定暴露哪些工具。按场景选，不确定就从 basic_edit 开始。

开发 Profile（推荐 AI 编程使用）：

切换方法：改 --profile 参数，重启服务。

微调 Bundle

Profile 不完全匹配时，用 --enable-bundle / --disable-bundle 加减：

# data_workflow + 结构编辑
--profile data_workflow --enable-bundle edit_structure  # 33 + 6 = 39

# 基础编辑 + 结构编辑
--profile basic_edit --enable-bundle edit_structure  # 35 + 6 = 41

可用 Bundle：

常用命令

# 查看可用 Profile / Bundle
--list-profiles
--list-bundles

# 诊断当前 Profile 的工具清单
--dump-tools
--dump-tools-with-index

# 查看 Profile 解析过程
--dump-profile-resolution

完整示例：

uv run python -m excelforge.gateway.host --config excel-mcp.yaml --profile basic_edit --dump-tools

MCP 客户端配置

{
  "mcpServers": {
    "excel": {
      "command": "uv",
      "args": [
        "run", "python", "-m", "excelforge.gateway.host",
        "--config", "YOUR_PROJECT_PATH/excel-mcp.yaml",
        "--profile", "data_workflow",
        "--restart-runtime", "if-stale"
      ],
      "cwd": "YOUR_PROJECT_PATH/"
    }
  }
}

• 开发环境用 --restart-runtime always，生产用 if-stale
• 更多示例见 mcp.example.json 及 examples/ 目录

文档