Haris Musa Excel MCP Server

🚀 Excel MCP サーバー

このモデルコンテキストプロトコル（MCP）サーバーを使用すると、Microsoft Excel をインストールせずに Excel ファイルを操作できます。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

💻 使用例

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 サーバーガイド

環境変数

📚 ドキュメント

このサーバーは、Excel 操作に必要な包括的なツールを提供しています。利用可能なすべてのツールの詳細なドキュメントについては、TOOLS.md を参照してください。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。詳細については LICENSE を参照してください。