Excel MCP Server

Excel MCP サーバー

Microsoft Excel をインストールせずに Excel ファイルを操作できる Model Context Protocol（MCP）サーバーです。AI エージェントを使って Excel ブックを作成、読み取り、変更できます。

機能

• 📊 Excel ブックの作成と変更
• 📝 データの読み取りと書き込み
• 🎨 書式とスタイルの適用
• 📈 グラフと可視化の作成
• 📊 ピボットテーブルの生成
• 🔄 ワークシートと範囲の管理

クイックスタート

前提条件

• Python 3.10 以降

インストール

1. リポジトリをクローンします：

git clone https://github.com/haris-musa/excel-mcp-server.git
cd excel-mcp-server

2. uv を使ってインストールします：

uv pip install -e .

サーバーの実行

サーバーを起動します（デフォルトポート：8000）：

uv run excel-mcp-server

ポートを指定する場合（例：8080）：

# Bash/Linux/macOS
export FASTMCP_PORT=8080 && uv run excel-mcp-server

# Windows PowerShell
$env:FASTMCP_PORT = "8080"; uv run excel-mcp-server

AI ツールでの使用

Cursor IDE

1. 次の設定を Cursor に追加します：

{
  "mcpServers": {
    "excel": {
      "url": "http://localhost:8000/sse",
      "env": {
        "EXCEL_FILES_PATH": "/path/to/excel/files"
      }
    }
  }
}

2. Excel ツールが AI アシスタントから利用できるようになります。

リモートホスティングとトランスポートプロトコル

このサーバーは Server-Sent Events（SSE）トランスポートプロトコルを使用します。用途に応じて、次の方法を利用できます。

1. Claude Desktop で使用する場合（stdio が必要）：

   • Supergateway を使用して SSE を stdio に変換します：

2. MCP サーバーをホスティングする場合：

   • リモート MCP サーバーガイド

環境変数

• FASTMCP_PORT：サーバーポート（デフォルト：8000）
• EXCEL_FILES_PATH：Excel ファイル用ディレクトリ（デフォルト：./excel_files）

利用可能なツール

このサーバーでは、Excel を操作するための幅広いツールを利用できます。利用可能なすべてのツールの詳細については、TOOLS.md を参照してください。

ライセンス

MIT License — 詳細については LICENSE を参照してください。