Spire XLS MCP Server

Spire.XLS MCP Server の README

Spire.XLS MCP Server とは？

Spire.XLS MCP Server は、Model Context Protocol（MCP）を使用して AI エージェントが Excel ファイルを操作できるようにする、堅牢なソリューションです。完全に独立しており、システムに Microsoft Office をインストールする必要はありません。このツールを使うと、AI エージェントは Excel ワークブックをシームレスに作成、読み取り、変更、変換できます。

主な機能：

• Excel を PDF、HTML、CSV、画像、XML などに高精度で変換します。
• Excel ワークブックを作成、変更、管理します。
• ワークシートを管理、制御します。名前の変更、移動、非表示、ウィンドウ枠の固定などが可能です。
• ワークシートとセル範囲を管理します。
• データを読み書きします。
• Excel データを分析します。
• さまざまな種類のグラフを追加して、データから視覚的な Excel ダッシュボードを作成します。
• Excel データを要約、分析、探索、提示するピボットテーブルを作成、操作します。

Spire.XLS MCP Server の使い方

前提条件

• Python 3.10 以降

インストール

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

git clone https://github.com/EiceblueCloud/Spire-XLS-MCP-Server.git
cd spire-xls-mcp-server

2. uv を使用してインストールします。

uv pip install -e .

サーバーの実行

サーバーを起動します（デフォルトのポートは 8000 です）。

uv run spire-xls-mcp-server

カスタムポート（例：8080）を指定します。

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

# Windows PowerShell
$env:FASTMCP_PORT = "8080"; uv run spire-xls-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 操作用の包括的なツールセットを提供します。主なカテゴリは次のとおりです。

• 基本操作：ワークブックとワークシートの作成、読み取り、書き込み、削除
• データ処理：セルデータの読み書き、数式の適用、並べ替え、フィルタリング
• 書式設定：スタイルの適用、セルの結合、フォントと色の設定
• 高度な機能：グラフ、ピボットテーブル、条件付き書式の作成
• 変換：Excel を PDF、HTML、CSV、画像、XML などに高精度で変換します。

利用可能なすべてのツールの詳細については、TOOLS.md を参照してください。

Spire.XLS MCP Server に関する FAQ

Spire.XLS MCP Server は任意のディレクトリで使用できますか？ はい、Spire.XLS MCP Serer は任意のディレクトリで動作します。

Spire.XLS MCP Server は無料で使用できますか？ はい、MIT ライセンスの下でライセンスされており、無料で使用、変更できます。

Spire.XLS MCP Server はどのプログラミング言語に対応していますか？ Python で構築されています。

ライセンス

MIT