使用说明

项目简介

Excel MCP Server 是一个实现了 Model Context Protocol (MCP) 的服务器,它为大型语言模型(LLM)提供了一系列工具,用于操作 Excel 文件。通过这个服务器,LLM 可以在无需安装 Microsoft Excel 的情况下,创建、修改和分析 Excel 工作簿,从而实现与电子表格数据的交互。

主要功能点

  • 全面的 Excel 功能支持:提供创建、读取、写入和修改 Excel 工作簿、工作表和单元格范围的功能。
  • 数据处理能力:支持读取、写入和转换 Excel 数据,方便 LLM 进行数据分析和处理。
  • 高级 Excel 特性:支持创建图表、透视表以及应用各种格式化样式,满足复杂的数据呈现和分析需求。
  • 无需 Excel 软件:基于 OpenPyXL 库,无需安装 Microsoft Excel 即可运行,降低了部署和使用门槛。
  • 易于集成:遵循 MCP 协议,可以通过标准的 JSON-RPC over SSE 协议与 MCP 客户端通信,方便集成到各种 LLM 应用中。

安装步骤

  1. 环境准备:确保已安装 Python 3.10 或更高版本。
  2. 克隆仓库:使用 Git 克隆仓库到本地:
    git clone https://github.com/haris-musa/excel-mcp-server
  3. 进入目录:切换到项目目录:
    cd excel-mcp-server
  4. 安装依赖:安装项目所需的 Python 库:
    pip install -r requirements.txt

服务器配置

为了让 MCP 客户端(例如 Cursor IDE 或 Claude Desktop)连接到 Excel MCP Server,您需要在客户端中配置服务器信息。以下是一个 JSON 格式的配置示例,您需要将其添加到 MCP 客户端的服务器配置中。

{
  "serverName": "excel",          // 自定义服务器名称,用于在客户端中标识
  "command": "uv run excel_mcp_server", // 启动服务器的命令,这里使用 'uv' 运行 'excel_mcp_server'
  "transport": "sse",            // 通信协议设置为 Server-Sent Events (SSE)
  "env": {                       // 环境变量配置(可选)
    "EXCEL_FILES_PATH": "./excel_files"  // Excel 文件存储路径,默认为项目目录下的 'excel_files' 文件夹
  }
}

基本使用方法

  1. 启动服务器:在项目根目录下,运行以下命令启动 Excel MCP Server:

    uv run excel_mcp_server

    服务器将以 SSE 模式启动,并等待 MCP 客户端连接。

  2. 客户端连接:在 MCP 客户端(如 Cursor IDE)中,根据上述 服务器配置 部分的信息配置并连接到 Excel MCP Server。

  3. 使用 Excel 工具:连接成功后,您就可以在 MCP 客户端中使用 Excel MCP Server 提供的工具了。这些工具允许 LLM 客户端执行各种 Excel 操作,例如创建工作簿、写入数据、应用公式、创建图表和透视表等。具体的工具列表和使用方法,请参考仓库中的 'TOOLS.md' 文件。

信息

分类

桌面与硬件