Excel MCP Server K5w

🚀 Excel MCP サーバー

このサーバーは、モデルコンテキストプロトコル（MCP）を利用しており、Microsoft Excel をインストールしなくても Excel ファイルを操作できます。Excel ワークブックの作成、読み取り、および編集が可能で、AI エージェントと連携して使用することもできます。

✨ 主な機能

• 📊 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 を参照してください。