使用说明
项目简介
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 应用中。
安装步骤
- 环境准备:确保已安装 Python 3.10 或更高版本。
- 克隆仓库:使用 Git 克隆仓库到本地:
git clone https://github.com/haris-musa/excel-mcp-server - 进入目录:切换到项目目录:
cd excel-mcp-server - 安装依赖:安装项目所需的 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' 文件夹 } }
基本使用方法
-
启动服务器:在项目根目录下,运行以下命令启动 Excel MCP Server:
uv run excel_mcp_server服务器将以 SSE 模式启动,并等待 MCP 客户端连接。
-
客户端连接:在 MCP 客户端(如 Cursor IDE)中,根据上述 服务器配置 部分的信息配置并连接到 Excel MCP Server。
-
使用 Excel 工具:连接成功后,您就可以在 MCP 客户端中使用 Excel MCP Server 提供的工具了。这些工具允许 LLM 客户端执行各种 Excel 操作,例如创建工作簿、写入数据、应用公式、创建图表和透视表等。具体的工具列表和使用方法,请参考仓库中的 'TOOLS.md' 文件。
信息
分类
桌面与硬件