Excel MCP Server 使用教程

1. 项目介绍

Excel MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器，它可以读取和写入 Microsoft Excel 数据。该项目支持读取文本值、公式，以及（在 Windows 系统上）捕获 Excel 文件的屏幕图像。它支持多种 Excel 文件格式，包括 xlsx、xlsm、xltx 和 xltm。

2. 项目快速启动

安装

通过 NPM 安装

Excel MCP Server 可以通过 NPM 自动安装。在 MCP 服务器配置中添加以下配置：

对于 Windows 系统：

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

对于其他平台：

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

通过 Smithery 安装

要使用 Smithery 自动安装 Excel MCP Server：

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

3. 应用案例和最佳实践

以下是一些典型的使用案例：

读取工作表名称

使用 read_sheet_names 方法列出 Excel 文件中所有工作表的名称：

const excelMcpServer = require('@negokaz/excel-mcp-server');
const fileAbsolutePath = 'path/to/your/excel/file.xlsx';

excelMcpServer.read_sheet_names(fileAbsolutePath).then(sheetNames => {
  console.log(sheetNames);
});

读取工作表数据

使用 read_sheet_data 方法读取 Excel 工作表中的数据：

const excelMcpServer = require('@negokaz/excel-mcp-server');
const fileAbsolutePath = 'path/to/your/excel/file.xlsx';
const sheetName = 'Sheet1';
const range = 'A1:C10';

excelMcpServer.read_sheet_data(fileAbsolutePath, sheetName, range).then(data => {
  console.log(data);
});

写入工作表数据

使用 write_sheet_data 方法向 Excel 工作表写入数据：

const excelMcpServer = require('@negokaz/excel-mcp-server');
const fileAbsolutePath = 'path/to/your/excel/file.xlsx';
const sheetName = 'Sheet1';
const range = 'A1:C10';
const data = [[1, 2, 3], [4, 5, 6], [7, 8, 9]];

excelMcpServer.write_sheet_data(fileAbsolutePath, sheetName, range, data).then(() => {
  console.log('Data written successfully');
});

4. 典型生态项目

目前，Excel MCP Server 的生态系统中没有列出具体的典型项目。但是，该服务器可以作为任何需要与 Excel 文件进行交互的项目的一部分，特别是在需要程序化地读取或写入大量数据时。它适用于自动化报告生成、数据分析任务以及任何涉及 Excel 数据处理的场景。