Excel MCP Server Lpx

🚀 Excel MCP 服務器

Excel MCP 服務器是一款強大的 Excel 文件處理工具，它支持對 Excel 文件的數據、公式及圖像進行讀取與寫入操作。同時，該服務器可通過標準輸入輸出或基於 HTTP 的 Server-Sent Events 實現通信，為用戶提供了便捷的數據處理方式。

🚀 快速開始

Excel MCP 服務器可幫助你輕鬆處理 Excel 文件中的數據、公式和圖像。你可以根據需求選擇合適的安裝方式和通信方式，快速開啟 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 文件瞭解具體流程。