ExcelReadMCP(可翻译为)“Excel读取MCP(或特定配置/模块/程序等,具体含义需根据上下文确定)”
ExcelReadMCP是一个专用服务器,用于从支持模型上下文协议(Model Context Protocol)的客户端(如Cursor和GitHub Copilot)读取Excel文件。它专门用于读取和搜索,不提供写入或格式化操作。
提供工具
| 工具名称 | 说明 |
|---|---|
excel_read_info 返回工作簿的元数据(工作表数量、工作表名称、文件大小等)。 | |
excel_read_range 将指定记录(或首记录)的内容作为记录数组返回。 | |
excel_read_all_sheets 读取所有工作表,并返回每个工作表的数据和处理状态。 | |
excel_quick_overview | 返回文件概要和各个工作表的示例行。 |
excel_search 在工作簿整体(或指定工作表)中搜索字符串。 |
重要: 在所有工具中 file_path (用于句尾,表示)对于、在……方面 绝对路径 请指定。如果传递相对路径,将会出错。通用设置
cd
python -m venv .venv
.venv\Scripts\activate
pip install -r requirements.txt执行示例: 文件夹C:\Projects\ExcelReadMCP若展开为cd C:\Projects\ExcelReadMCP→python -m venv .venv→.\.venv\Scripts\Activate.ps1→pip install -r requirements.txt然后按顺序在 PowerShell 中执行。
补充: 作为官方的MCP库mcp因为使用了软件包(当前稳定版为1.18.0)requirements.txt也就是说,指定的是该版本以上的版本。
在Cursor中的设置
mcp_config.json打开`
` 将其替换为实际的绝对路径。
- Cursor引用的MCP设置文件(例如:
%USERPROFILE%\.cursor\mcp.json)后追加。 - 重启 Cursor,进入 Settings > Features > MCP
excel-read-mcp确认会显示“”。 - Composer(
Ctrl+I)中“C:\path\to\workbook.xlsx指示“获取工作表列表”等,以确认工具可用。
在GitHub Copilot上的设置
mcp_config.json打开`
` 将其替换为实际的绝对路径。
- 如果是Windows系统的话
%APPDATA%\GitHub Copilot\mcp.json进行编辑excel-read-tools请补充相关设置(若文件不存在,请新建)。 - 重启 VS Code,然后在 Copilot Chat 的工具列表中
excel-read-tools确认显示。 - 在Copilot Chat中输入“
C:\path\to\workbook.xlsx并指示“确认该内容”等,以测试工具的响应。
服务器启动
cd
start_mcp_server.bat如果存在虚拟环境 .venv 如果Python不存在,则为系统的 python 会被使用。
