Excelreadmcp

🚀 ExcelReadMCP

ExcelReadMCP 是一个专门的服务器，用于从支持 Model Context Protocol 的客户端（如 Cursor 和 GitHub Copilot）读取 Excel 文件。它专注于读取和搜索操作，不提供写入或格式设置等操作。

✨ 主要特性

提供了一系列实用工具，用于对 Excel 文件进行不同类型的操作。

📦 安装指南

共通设置

cd <path-to-ExcelReadMCP>
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 包（当前稳定版本为 1.18.0）作为 MCP 库，因此在 requirements.txt 中指定了该版本或更高版本。

Cursor 中的设置

1. 打开 mcp_config.json，将 <path-to-ExcelReadMCP> 替换为实际的绝对路径。
2. 将其内容追加到 Cursor 引用的 MCP 配置文件（例如：%USERPROFILE%\.cursor\mcp.json）中。
3. 重启 Cursor，确认 Settings > Features > MCP 中显示 excel-read-mcp。
4. 在 Composer（Ctrl + I）中输入「C:\path\to\workbook.xlsx 的工作表列表」等指令，确认工具可以正常使用。

GitHub Copilot 中的设置

1. 打开 mcp_config.json，将 <path-to-ExcelReadMCP> 替换为实际的绝对路径。
2. 在 Windows 系统中，编辑 %APPDATA%\GitHub Copilot\mcp.json，并添加 excel-read-tools 的配置（如果文件不存在，请创建一个新文件）。
3. 重启 VS Code，确认 Copilot Chat 的工具列表中显示 excel-read-tools。
4. 在 Copilot Chat 中输入「确认 C:\path\to\workbook.xlsx 的内容」等指令，测试工具的响应。

💻 使用示例

提供的工具

⚠️ 重要提示

所有工具的 file_path 参数都必须指定 绝对路径。传递相对路径会导致错误。

🚀 快速开始

启动服务器

cd <path-to-ExcelReadMCP>
start_mcp_server.bat

如果存在虚拟环境，则使用 .venv 中的 Python；如果不存在，则使用系统的 python。