Cellpilot MCP

🚀 CELLPILOT MCP

CELLPILOT MCP 是一個強大的模型上下文協議（MCP）服務器，它能讓像 GitHub Copilot 這樣的 AI 助手讀取、寫入和操作 Excel 文件（.xlsx 和 .xls）。該服務器基於 C# 和 NPOI 庫構建，通過一系列直觀的工具提供全面的 Excel 功能。

🚀 快速開始

CELLPILOT MCP 服務器可讓 AI 助手輕鬆操作 Excel 文件。只需完成配置，即可讓 AI 助手執行各種 Excel 操作。

✨ 主要特性

📁 文件操作

• GetExcelFileInfo - 獲取文件元數據，包括工作表名稱、行數和列數。
• CopyExcelFile - 將 Excel 文件複製到新位置。
• ListSheets - 列出工作簿中的所有工作表名稱。
• CreateWorkbook - 創建新的 Excel 工作簿（.xlsx 或 .xls）。

📖 讀取數據

• ReadCell - 讀取特定單元格的值。
• ReadRange - 將一系列單元格作為二維數組讀取。
• GetSheetData - 獲取工作表中的所有數據。
• GetCellFormula - 檢索單元格中的公式。

🔍 搜索

• SearchInSheet - 在工作表中搜索值。
• SearchInWorkbook - 在工作簿的所有工作表中搜索。
• SearchInColumn - 在特定列中搜索。
• SearchWithRegex - 使用正則表達式進行搜索。
• SearchNumericRange - 查找包含指定範圍內數字的單元格。
• SearchDateRange - 查找包含指定範圍內日期的單元格。

✍️ 寫入數據

• WriteCell - 向單元格寫入值。
• WriteRange - 寫入二維數組數據。
• SetCellFormula - 在單元格中設置公式。
• ClearRange - 清除一系列單元格的內容。

📊 工作表管理

• CreateSheet - 創建新的工作表。
• RenameSheet - 重命名現有工作表。
• DeleteSheet - 從工作簿中刪除工作表。
• CopySheet - 在工作簿內複製工作表。

🔧 單元格及行/列操作

• InsertRow / DeleteRow - 添加或刪除行。
• InsertColumn / DeleteColumn - 添加或刪除列。
• MergeCells / UnmergeCells - 合併或取消合併單元格區域。
• ListMergedRegions - 列出工作表中的所有合併區域。
• AutoSizeColumn - 自動調整列寬以適應內容。
• SetColumnWidth - 設置特定列的寬度。

📦 安裝指南

從 NuGet.org 安裝

使用 dnx 命令在 IDE 中配置 MCP 服務器：

• VS Code - 創建 .vscode/mcp.json 文件：

{
  "servers": {
    "CellPilotMCP": {
      "type": "stdio",
      "command": "dnx",
      "args": [
        "CellPilotMCP",
        "--version",
        "0.0.1",
        "--yes"
      ]
    }
  }
}

• Visual Studio - 在解決方案目錄中創建 .mcp.json 文件，結構相同。

從源代碼安裝（本地開發）

{
  "servers": {
    "CellPilotMCP": {
      "type": "stdio",
      "command": "dotnet",
      "args": [
        "run",
        "--project",
        "<項目目錄路徑>"
      ]
    }
  }
}

💻 使用示例

配置完成後，你可以讓 AI 助手執行 Excel 操作，例如：

• "讀取 my-file.xlsx 文件中 Sheet1 的所有數據"
• "創建一個包含姓名、電子郵件和電話列的新 Excel 文件"
• "在工作簿中搜索所有包含 'Total' 的單元格"
• "在單元格 C10 中寫入一個對 C1:C9 求和的 SUM 公式"
• "合併 A1 到 D1 的單元格作為標題行"
• "自動調整 Sheet1 中所有列的寬度"

📚 詳細文檔

本 MCP 服務器使用 ModelContextProtocol C# SDK。

MCP 資源：

• 官方文檔
• 協議規範
• GitHub 組織

IDE 配置：

• 在 VS Code 中使用 MCP 服務器（預覽版）
• 在 Visual Studio 中使用 MCP 服務器（預覽版）

📄 許可證

本項目採用 MIT 許可證。

🔧 技術細節

支持的平臺

MCP 服務器是一個自包含的應用程序，無需安裝 .NET 運行時。支持的平臺包括：

• win-x64 / win-arm64
• osx-arm64
• linux-x64 / linux-arm64 / linux-musl-x64