Excelreadmcp

🚀 ExcelReadMCP

ExcelReadMCPは、CursorやGitHub CopilotなどのModel Context Protocol対応クライアントからExcelファイルを読み取るための専用サーバーです。読み込みと検索に特化しており、書き込みや整形系の操作は提供しません。

✨ 主な機能

提供ツール

⚠️ 重要提示

すべてのツールで file_path には 絶対パス を指定してください。相対パスを渡すとエラーになります。

📦 インストール

共通セットアップ

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ライブラリとして公式の mcp パッケージ（現在の安定版は1.18.0）を利用しているため、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 の内容を確認して」などと指示し、ツールの応答をテストします。

🚀 クイックスタート

サーバーの起動

cd <path-to-ExcelReadMCP>
start_mcp_server.bat

仮想環境が存在する場合は .venv のPython、存在しない場合はシステムの python が使用されます。