MCP Excelautocpp

🚀 C++ Excel自動化MCP服務器

這是一個基於C++的Excel自動化MCP（模型上下文協議）服務器項目。它利用OpenXLSX庫進行Excel文件操作，並旨在通過MCP協議，藉助大語言模型（LLM）的能力，提供一套智能的Excel操作工具。

🚀 快速開始

本項目使用CMake進行構建，推薦安裝Ninja以實現更快的編譯速度。

準備環境

• 確保你已安裝C++17編譯器、CMake（版本 >= 3.15）和Ninja。
• 克隆倉庫：git clone https://github.com/smileFAace/MCP-ExcelAutoCpp.git

編譯

# 切換到項目目錄（如果當前不在根目錄）
# cd MCP-ExcelAutoCpp

# 生成構建文件（推薦使用Ninja）
cmake -G "Ninja" -S . -B build

# 執行編譯
cmake --build build

編譯後的可執行文件通常位於bin/目錄中。

啟動服務器

編譯成功後，在./bin/目錄中找到名為ExcelAutoCpp（Linux/macOS）或ExcelAutoCpp.exe（Windows）的可執行文件。

# 示例（根據需要調整路徑）
./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）語言。

✨ 主要特性

• 簡單易用的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（二維數組）：要寫入該範圍的值的二維數組（支持null、布爾值、數字、字符串類型）。

create_xlsx_file_by_absolute_path

• 注意：此工具在代碼中定義的名稱為create_xlsx_file_by_absolute_path，但JSON中的鍵為create_xlsx。
• 描述：使用給定的路徑創建一個新的xlsx文件。創建完成後自動關閉Excel文件。
• 參數：
  • file_path（字符串）：文件應創建的絕對路徑。

(注意：工具描述中提到的自動打開/關閉行為是內部實現細節，不需要用戶關注。)

📦 下載

你可以從發佈頁面下載最新版本。