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。