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