Excel MCP Server 使用说明

项目简介

Excel MCP Server 是一个实现了 Model Context Protocol (MCP) 的服务器，专注于为大型语言模型 (LLM) 提供访问和操作 Microsoft Excel 文件的能力。通过此服务器，LLM 可以读取 Excel 工作表中的数据、将数据写入 Excel 工作表以及获取工作表列表，从而实现与电子表格数据的交互。

主要功能点

读取Excel数据: 允许 LLM 读取指定 Excel 文件和工作表中的文本数据，并以 HTML 表格形式返回。支持指定读取范围，并对大数据量读取进行限制。
写入Excel数据: 允许 LLM 将二维文本数据写入到指定的 Excel 文件和工作表中的指定范围。
列出工作表名称: 允许 LLM 获取指定 Excel 文件中所有工作表的名称列表。

安装步骤

通过 NPM 安装 (推荐)

确保已安装 Node.js 20.x 或更高版本。

将以下配置添加到 MCP 客户端的服务器配置文件中。

Windows 平台:

{
  "mcpServers": {
    "excel": {
        "command": "cmd",
        "args": ["/c", "npx", "--yes", "@negokaz/excel-mcp-server"]
    }
  }
}

其他平台 (macOS, Linux):

{
  "mcpServers": {
    "excel": {
        "command": "npx",
        "args": ["--yes", "@negokaz/excel-mcp-server"]
    }
  }
}

'server name': 'excel' (用户可以自定义，用于在MCP客户端中引用此服务器)
'command': 服务器启动命令。Windows 平台使用 'cmd /c npx'，其他平台使用 'npx'。
'args': 命令参数。'--yes @negokaz/excel-mcp-server' 表示使用 'npx' 执行 '@negokaz/excel-mcp-server' 包，'--yes' 参数用于自动确认安装包。

通过 Smithery 安装

如果您使用 Claude Desktop 客户端，可以使用 Smithery 工具自动安装 Excel MCP Server：

npx -y @smithery/cli install @negokaz/excel-mcp-server --client claude

服务器配置

MCP 客户端需要配置 Excel MCP Server 的启动命令和参数才能连接。以下是配置示例，请根据您的平台选择合适的配置添加到 MCP 客户端的服务器配置文件中 (通常是一个 JSON 文件)。

Windows 平台配置示例:

{
  "mcpServers": {
    "excel": {
      "command": "cmd",
      "args": ["/c", "npx", "--yes", "@negokaz/excel-mcp-server"]
    }
  }
}

macOS 或 Linux 平台配置示例:

{
  "mcpServers": {
    "excel": {
      "command": "npx",
      "args": ["--yes", "@negokaz/excel-mcp-server"]
    }
  }
}

基本使用方法

启动 Excel MCP Server: 当 MCP 客户端启动并加载配置后，Excel MCP Server 将自动启动并运行。
LLM 调用工具: 在 LLM 应用中，可以使用以下工具与 Excel MCP Server 交互：
- 'read_sheet_data': 读取 Excel 工作表数据。
  - 参数:
    - 'fileAbsolutePath': Excel 文件的绝对路径。 (必填)
    - 'sheetName': 工作表名称。 (必填)
    - 'range': 要读取的单元格范围，例如 "A1:C10"。 (可选，默认为整个工作表范围)
- 'write_sheet_data': 写入 Excel 工作表数据。
  - 参数:
    - 'fileAbsolutePath': Excel 文件的绝对路径。 (必填)
    - 'sheetName': 工作表名称。 (必填)
    - 'range': 要写入的单元格范围，例如 "A1:C10"。 (必填)
    - 'data': 要写入的二维数组数据。 (必填)
- 'read_sheet_names': 列出 Excel 文件中的工作表名称。
  - 参数:
    - 'fileAbsolutePath': Excel 文件的绝对路径。 (必填)
数据交互: LLM 通过 MCP 协议向 Excel MCP Server 发送 JSON-RPC 请求调用工具，服务器执行相应的 Excel 操作并将结果以 JSON-RPC 响应返回给 LLM。

示例场景: LLM 可以使用 'read_sheet_data' 工具读取 Excel 文件中的产品价格表，然后使用这些数据回答用户关于产品价格的查询。或者，LLM 可以分析用户对话，并将对话内容或分析结果使用 'write_sheet_data' 工具写入到 Excel 文件中进行记录或报告生成。

关键词