Spire Xls MCP Server

🚀 Spire.XLS MCP Serverとは？

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

✨ 主な機能

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

🚀 クイックスタート

前提条件

• Python 3.10以上

📦 インストール

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

git clone https://github.com/eiceblue/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サーバーをホスティングする場合：

   • Remote MCP Server Guideを参照してください。

環境変数

利用可能なツール

サーバーは、Excel操作に関する包括的なツールセットを提供しています。主なカテゴリは以下の通りです：

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

利用可能なすべてのツールの完全なドキュメントについては、TOOLS.mdを参照してください。

Spire.XLS MCP Serverに関するFAQ

Q1. Spire.XLS MCP Serverは任意のディレクトリで使用できますか？

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

Q2. Spire.XLS MCP Serverは無料で使用できますか？

はい、MITライセンスの下で提供されており、無料で使用および変更することができます。

Q3. Spire.XLS MCP Serverはどのプログラミング言語をサポートしていますか？

このサーバーはPythonで構築されています。

📄 ライセンス

MIT