ExcelReadMCP
Enables reading and searching Excel files through MCP-compatible clients. Provides tools to retrieve workbook metadata, read sheet contents, and search across all sheets using absolute file paths.
README
ExcelReadMCP
ExcelReadMCP は、Cursor や GitHub Copilot などの Model Context Protocol 対応クライアントから Excel ファイルを読み取るための専用サーバーです。読み込み・検索に特化しており、書き込みや整形系の操作は提供しません。
提供ツール
| ツール名 | 説明 |
|---|---|
excel_read_info |
ワークブックのメタ情報（シート数、シート名、ファイルサイズなど）を返します。 |
excel_read_range |
指定シート（または先頭シート）の内容をレコード配列として返します。 |
excel_read_all_sheets |
全シートを読み込み、シートごとのデータと処理状況を返します。 |
excel_quick_overview |
ファイル概要と各シートのサンプル行を返します。 |
excel_search |
ワークブック全体（または指定シート）から文字列を検索します。 |
重要: すべてのツールで
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 でのセットアップ
mcp_config.jsonを開き、<path-to-ExcelReadMCP>を実際の絶対パスに置き換えます。- その内容を 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を開き、<path-to-ExcelReadMCP>を実際の絶対パスに置き換えます。- Windows の場合は
%APPDATA%\GitHub Copilot\mcp.jsonを編集し、excel-read-toolsの設定を追記します（ファイルが無い場合は新規作成してください）。 - VS Code を再起動し、Copilot Chat のツール一覧に
excel-read-toolsが表示されることを確認します。 - Copilot Chat に「
C:\path\to\workbook.xlsxの内容を確認して」などと指示し、ツールの応答をテストします。
サーバーの起動
cd <path-to-ExcelReadMCP>
start_mcp_server.bat
仮想環境が存在する場合は .venv の Python、存在しない場合はシステムの python が使用されます。
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.