Excel MCP Server Lpx

🚀 Excel MCP サーバー

Excel MCP サーバーは、Excel ファイルを処理するツールです。データ、数式、画像の読み取りと書き込みをサポートしています。標準入出力（stdio）または HTTP ベースの Server-Sent Events（SSE）を通じて通信することができます。

[]

🚀 クイックスタート

Excel MCP サーバーを使うことで、Excel ファイルのデータや数式、画像の読み書きが簡単に行えます。以下に、基本的な使い方を説明します。

✨ 主な機能

• データの読み取り：指定範囲からセルの内容を抽出します。
• 数式の読み取り：特定の範囲内のセルの数式を取得します。
• 画像の読み取り：[Windows システム] ワークシートから指定範囲の画像データを抽出します。
• データの書き込み：Excel ファイルの指定範囲に新しいデータを書き込みます。
• 数式の書き込み：指定範囲に新しい数式を書き込みます。

📦 インストール

NPM を使用したインストール

1. 依存関係をインストールします。

npm install @fbeawels/excel-mcp-server

2. サーバーを起動します（オプション引数あり）。

npx @fbeawels/excel-mcp-server [--transport stdio|sse] [--host <アドレス>] [--port <ポート>]

Smithery を使用したインストール

1. package.json に依存関係を追加します。

{
  "dependencies": {
    "@fbeawels/excel-mcp-server": "^1.0.0"
  }
}

2. サーバーを起動します（オプション引数あり）。

npx @fbeawels/excel-mcp-server [--transport stdio|sse] [--host <アドレス>] [--port <ポート>]

💻 使用例

データの読み取り

Excel ファイルから指定範囲のデータを読み取ります。

{
  "action": "readData",
  "params": {
    "file": "<ファイルパス>",
    "sheet": "<ワークシート名>",
    "range": "<セル範囲>"
  }
}

数式の読み取り

Excel ファイルから指定範囲の数式を読み取ります。

{
  "action": "readFormula",
  "params": {
    "file": "<ファイルパス>",
    "sheet": "<ワークシート名>",
    "range": "<セル範囲>"
  }
}

画像の読み取り

[Windows システム] Excel ファイルから指定範囲の画像データを抽出します。

{
  "action": "readImage",
  "params": {
    "file": "<ファイルパス>",
    "sheet": "<ワークシート名>",
    "range": "<セル範囲>"
  }
}

データの書き込み

Excel ファイルの指定範囲に新しいデータを書き込みます。

{
  "action": "writeData",
  "params": {
    "file": "<ファイルパス>",
    "sheet": "<ワークシート名>",
    "range": "<セル範囲>",
    "data": "<書き込むデータ>"
  }
}

数式の書き込み

Excel ファイルの指定範囲に新しい数式を書き込みます。

{
  "action": "writeFormula",
  "params": {
    "file": "<ファイルパス>",
    "sheet": "<ワークシート名>",
    "range": "<セル範囲>",
    "formulas": "<書き込む数式>"
  }
}

📚 ドキュメント

コマンドライン引数

以下のコマンドライン引数をサポートしています。

• --transport <タイプ>：伝送方式を設定します。stdio または sse が選択可能です。
• --host <アドレス>：SSE 伝送時にバインドするホストアドレスを設定します。デフォルトはすべてのインターフェースです。
• --port <ポート>：SSE 伝送時に使用するポート番号を設定します。デフォルトは 8000 です。

使用例：

npx @fbeawels/excel-mcp-server --transport sse --host 0.0.0.0 --port 8000

環境変数

以下の環境変数を使用してサーバーの動作を調整できます。

• EXCEL_MCP_PAGING_CELLS_LIMIT：一度に読み取る最大セル数を設定します。デフォルトは 4000 です。
• EXCEL_MCP_TRANSPORT：伝送方式を設定します。stdio または sse が選択可能で、デフォルトは stdio です。
• EXCEL_MCP_HOST：SSE 伝送時にバインドするホストアドレスを設定します。デフォルトは空文字列（すべてのインターフェース）です。
• EXCEL_MCP_PORT：SSE 伝送時に使用するポート番号を設定します。デフォルトは 8000 です。

📄 ライセンス

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

🔗 貢献ガイド

問題の報告や貢献を歓迎します！具体的な流れについては CONTRIBUTING.md ファイルを参照してください。