MCP Excelautocpp

🚀 C++ Excel Automation MCP Server

このプロジェクトは、C++をベースにしたExcel Automation MCP（Model Context Protocol）サーバーです。OpenXLSXライブラリを使用してExcelファイルを操作し、MCPプロトコルを通じてLLMの機能を活用した、高度なExcel操作ツールセットを提供することを目的としています。

🚀 クイックスタート

このサーバーを使用するには、まずプロジェクトをビルドし、サーバーを起動する必要があります。詳細な手順は以下の通りです。

✨ 主な機能

• シンプルで使いやすいMCPインターフェース：標準化されたMCPツールを提供し、クライアント（AIアシスタントなど）がExcel自動化機能を簡単に呼び出せるようにします。
• 単一ファイルでのデプロイ：単一の実行可能ファイルにコンパイルされ、デプロイと実行が容易です。
• カスタマイズ可能な多言語サポート：JSONファイルを介してインターフェースの言語を簡単に追加または変更できます。

サーバーの機能

このMCPサーバーは、以下のツールを提供し、LLMがxlsxスプレッドシートファイルとやり取りできるようにします。

• open_excel_and_list_sheets：
  • 説明：Excelファイルを開き、すべてのシート名を表示します。このツールは、後続の操作のために現在のExcelファイルパスも設定します。操作を開始する前または変更するファイルを変更する場合は、最初にこのツールを実行することをお勧めします。
  • パラメータ：
    • file_path (文字列)：Excelファイルの絶対パス。
• get_sheet_range_content：
  • 説明：特定のシート内の指定された範囲のテーブル内容を取得して出力します。Excelファイルを自動的に開閉します。
  • パラメータ：
    • sheet_name (文字列)：読み取るシートの名前。
    • first_row (数値)：開始行番号（1から始まるインデックス）。
    • first_column (数値)：開始列番号（1から始まるインデックス）。
    • last_row (数値)：終了行番号（1から始まるインデックス）。
    • last_column (数値)：終了列番号（1から始まるインデックス）。
    • cell_with_coord (ブール値、オプション)：非空のセルをそれぞれの座標とともに出力します。出力領域に多数の空のセルが含まれる場合に適しています。
• set_sheet_range_content：
  • 説明：特定のシート内の指定された範囲のテーブル内容を設定します。Excelファイルを自動的に開閉します。
  • パラメータ：
    • sheet_name (文字列)：書き込むシートの名前。
    • first_row (数値)：開始行番号（1から始まるインデックス）。
    • first_column (数値)：開始列番号（1から始まるインデックス）。
    • values (配列[配列])：範囲に書き込む2次元配列の値（null、ブール値、数値、文字列型をサポート）。
• create_xlsx_file_by_absolute_path：(注: ツール名はコード内でこのように定義されていますが、JSON内のキーはcreate_xlsxです)
  • 説明：指定されたパスに新しいxlsxファイルを作成します。作成後、Excelファイルを自動的に閉じます。
  • パラメータ：
    • file_path (文字列)：ファイルを作成する絶対パス。

(注: ツールの説明で言及されている自動的な開閉動作は内部実装の詳細であり、ユーザーが意識する必要はありません。)

📦 インストール

このプロジェクトはCMakeを使用してビルドされます。高速なコンパイル速度を得るために、Ninjaのインストールをお勧めします。

ビルド手順

1. 環境の準備：
   • C++17コンパイラ、CMake（>= 3.15）、およびNinjaがインストールされていることを確認してください。
   • リポジトリをクローンします：git clone https://github.com/smileFAace/MCP-ExcelAutoCpp.git
2. コンパイル：

   # プロジェクトディレクトリに移動（ルートにいない場合）
   # cd MCP-ExcelAutoCpp
   
   # ビルドファイルを生成（Ninja推奨）
   cmake -G "Ninja" -S . -B build
   
   # コンパイルを実行
   cmake --build build
   

   コンパイルされた実行可能ファイルは通常、bin/ディレクトリにあります。

💻 使用例

基本的な使用法

コンパイルが成功した後、./bin/ディレクトリ内にExcelAutoCpp（Linux/macOS）またはExcelAutoCpp.exe（Windows）という名前の実行可能ファイルが見つかります。

サーバーの起動 実行可能ファイルを実行するだけで、MCPサーバーを起動できます。

# 例（パスは必要に応じて調整）
./bin/ExcelAutoCpp

以下のような出力が表示されたら、サーバーが正常に起動し、localhost:8888で待機しています。

░█▀▀░█░█░█▀▀░█▀▀░█░░░█▀█░█░█░▀█▀░█▀█
░█▀▀░▄▀▄░█░░░█▀▀░█░░░█▀█░█░█░░█░░█░█
░▀▀▀░▀░▀░▀▀▀░▀▀▀░▀▀▀░▀░▀░▀▀▀░░▀░░▀▀▀
v0.0.2                 By smileFAace

I(17:35:48) i18n: Successfully loaded language string for language code 'en'
I(17:35:48) i18n: Set current language to 'en'
W(17:35:48) lang.json not found at 'E:\prj\MCP-ExcelAutoCpp\bin\lang.json'. Using default language.
I(17:35:48) i18n: Set current language to 'en'
I(17:35:48) Current language set to: en
I(17:35:48) Starting MCP server at localhost:8888
I(17:35:48) Press Ctrl+C to stop the server

接続と使用 このサーバーはMCPプロトコルに準拠しています。MCP互換のクライアント（Roo、cline、claude、cherry studioなど）を使用して、サーバーのSSEエンドポイント（デフォルト: http://localhost:8888/sse）に接続し、提供されているExcel自動化ツールを呼び出すことができます。

例えば、clineでこのMCPサーバーを構成するには、サーバーが正常に起動した後、プラグインが提供するmcp構成JSONファイルに以下の内容を追加し、その後リフレッシュします。

{
  "mcpServers": {
    "excel-auto-cpp": {
      "url": "http://localhost:8888/sse"
    }
  }
}

サーバー言語の変更とカスタマイズ サーバーのインターフェース言語はデフォルトで英語（en）に設定されています。カスタム言語ファイルを作成することで言語を変更できます。

1. サーバーの実行可能ファイルが含まれているディレクトリ（通常はbin/）を見つけます。
2. そのディレクトリにlang.jsonという名前のテキストファイルを作成します。
3. 希望する言語の完全なキーバリューペアをこのlang.jsonファイルにコピーします。
   • プロジェクトソースコードのlang/ディレクトリ内の*.jsonファイルをテンプレートとして参照できます（例: には中国語の翻訳が含まれています）。
   • lang.jsonファイルには、プログラムのインターフェースとログに必要なすべての翻訳エントリが含まれている必要があります。
4. lang.jsonファイルを保存し、サーバーを再起動します。
   • サーバーは起動時にこのファイルを自動的に検出して読み込みます。正常に読み込まれた場合、lang.jsonで定義された言語が使用されます。
   • lang.jsonファイルが存在しない、形式が正しくない、または必要な翻訳エントリが欠落している場合、サーバーはデフォルトの英語（en）にフォールバックします。

ダウンロード

最新のリリースはReleasesページからダウンロードできます。