Excel MCP Server 安装与配置指南

1. 项目基础介绍

Excel MCP Server 是一个开源项目，它实现了 Model Context Protocol (MCP) 服务器，用于读取和写入 Microsoft Excel 文件数据。这个项目主要使用 Go 和 JavaScript 编程语言，支持多种 Excel 文件格式，如 xlsx、xlsm、xltx 和 xltm。

2. 项目使用的关键技术和框架

• Go 语言：项目的主要后端语言，用于构建 MCP 服务器。
• JavaScript：用于前端的交互和配置。
• Docker：用于容器化应用，便于部署和运行。
• NPM：Node.js 包管理器，用于管理项目依赖。
• Smithery：一个自动化工具，用于项目的自动安装和配置。

3. 项目安装和配置的准备工作与详细步骤

准备工作

在开始安装之前，请确保您的系统满足以下要求：

• Node.js：版本 20.x 或更高版本。可以通过 node -v 检查版本。
• Git：用于克隆和更新项目代码。

安装步骤

步骤 1：克隆项目

首先，打开终端或命令提示符，然后克隆项目仓库：

git clone https://github.com/negokaz/excel-mcp-server.git
cd excel-mcp-server

步骤 2：安装依赖

使用 NPM 安装项目依赖：

npm install

步骤 3：配置 MCP 服务器

根据您的操作系统，配置 MCP 服务器的启动脚本。以下是为 Windows 系统配置的示例：

在项目的根目录下创建一个名为 start_server.bat 的批处理文件，并添加以下内容：

@echo off
setlocal
set MCP_SERVER_PATH=@negokaz/excel-mcp-server
npx --yes %MCP_SERVER_PATH%
endlocal

对于其他平台（如 macOS 或 Linux），创建一个名为 start_server.sh 的脚本文件，并添加以下内容：

#!/bin/bash
npx --yes @negokaz/excel-mcp-server

然后，确保脚本文件是可执行的：

chmod +x start_server.sh

步骤 4：启动 MCP 服务器

对于 Windows，运行以下命令启动服务器：

.\start_server.bat

对于其他平台，运行以下命令启动服务器：

./start_server.sh

配置说明

• EXCEL_MCP_PAGING_CELLS_LIMIT：这个环境变量可以设置单次分页操作中读取的最大单元格数。默认值是 4000。

完成以上步骤后，您的 Excel MCP Server 应该已经成功安装并运行了。您可以开始使用它来读取和写入 Excel 文件数据。