项目简介

ExcelMcp 是一个强大的 Model Context Protocol (MCP) 服务器,专门用于连接AI助手(如GitHub Copilot或Claude)与Microsoft Excel。它使得用户可以通过自然语言命令直接自动化Excel中的复杂任务,无需编写任何代码或公式。ExcelMcp 利用Excel的原生COM API,确保了操作的安全性与兼容性,涵盖了数据转换、格式设置、高级分析和工作流自动化等160多种操作。

主要功能点

ExcelMcp 提供了11个专业工具,共计166项操作,让AI助手能够全面控制Excel:

  • Power Query (M语言):创建、编辑、管理查询,控制加载目的地,进行错误诊断。
  • Power Pivot (DAX模型):构建DAX度量值,管理数据模型关系,发现模型结构。
  • Excel 表格 (ListObjects):自动化表格的创建、格式化、筛选、排序、列管理等。
  • 数据透视表 (PivotTables):创建和配置数据透视表,进行交互式分析。
  • VBA 宏 (VBA Macros):导出、导入、运行VBA代码,集成版本控制。
  • 范围与数据 (Ranges & Data):获取/设置单元格值和公式,复制/粘贴,查找/替换,格式化,数据验证,条件格式等。
  • 工作表 (Worksheets):管理工作表的生命周期、标签颜色和可见性。
  • 数据连接 (Connections):管理OLEDB、ODBC、文本、Web等数据源连接。
  • 命名区域 (Named Ranges):管理命名区域的创建、删除、更新和值设置。
  • 文件操作 (File Operations):创建空Excel文件,关闭文件,进行文件测试。
  • 批处理 (Batch Operations):支持多操作批处理,显著提升性能。

安装步骤

ExcelMcp 服务器需要Windows操作系统和Microsoft Excel 2016或更高版本。

推荐方式:VS Code 扩展 (一键安装)

这是最快捷的启动方式,所有配置都会自动完成:

  1. 安装扩展
    • 打开 VS Code,进入扩展视图('Ctrl+Shift+X')。
    • 搜索 "ExcelMcp"
    • 点击 安装
  2. 自动配置:扩展会自动安装 .NET 8 运行时,并捆绑MCP服务器,自动注册到AI助手,并显示快速入门指南。
  3. 开始使用:安装完成后,扩展会自动打开一个快速入门指南,你可以立即开始通过AI助手与Excel对话。

手动安装 (高级用户)

适用于非VS Code环境或需要手动配置的用户:

  1. 安装 .NET 8 SDK
    winget install Microsoft.DotNet.SDK.8
  2. 安装 ExcelMcp MCP 服务器作为全局工具
    dotnet tool install --global Sbroenne.ExcelMcp.McpServer
    如需更新到最新版本:
    dotnet tool update --global Sbroenne.ExcelMcp.McpServer

服务器配置 (针对MCP客户端)

为了让你的AI助手(MCP客户端)能找到并启动ExcelMcp服务器,你需要在AI助手的配置中添加服务器启动信息。这通常涉及一个JSON文件,指定了启动服务器的命令及其参数。

示例配置(以GitHub Copilot为例):

假设你的AI助手客户端在 '.vscode/mcp.json' 或 '%USERPROFILE%.mcp.json' 文件中配置MCP服务器,你需要添加以下内容:

{
  "servers": {
    "excel": {
      "command": "dotnet",
      "args": ["tool", "run", "mcp-excel"]
    }
  }
}
  • '"excel"': 这是你在AI助手中为ExcelMcp服务器定义的唯一名称。
  • '"command": "dotnet"': 指定了用于启动ExcelMcp服务器的可执行程序是'.NET'运行时。
  • '"args": ["tool", "run", "mcp-excel"]': 这些是传递给'dotnet'命令的参数,用于运行ExcelMcp作为全局.NET工具。'mcp-excel'是ExcelMcp CLI的别名。

这个配置告诉AI助手如何启动ExcelMcp进程,然后通过标准输入输出(Stdio)通道进行通信。无需额外的服务器端配置。

基本使用方法

安装并配置完成后,你就可以像与AI对话一样指示ExcelMcp执行任务:

  1. 启动AI助手:在你的IDE(如VS Code)中启动GitHub Copilot或Claude桌面版。

  2. 提出请求:在AI助手的对话框中,用自然语言描述你希望Excel完成的任务。

    例子:

    • '"创建一个名为 'test.xlsx' 的空Excel文件,并添加一个从CSV文件加载数据的Power Query。"'
    • '"优化我这个工作簿中所有的Power Query,提高性能。"'
    • '"从 'SalesData' 表创建一个数据透视表,按区域显示前10个产品,并计算总和与平均值。"'
    • '"格式化所有营收列为货币类型,将标题加粗,背景设为蓝色,并为表格添加边框。"'

AI助手会解析你的请求,并通过ExcelMcp服务器生成并执行相应的Excel自动化命令。

信息

分类

生产力应用