JinDaGe - cellpilot-mcp MCP Details

article

README

🚀 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 资源：

IDE 配置：

📄 许可证

本项目采用 MIT 许可证。

🔧 技术细节

支持的平台

MCP 服务器是一个自包含的应用程序，无需安装 .NET 运行时。支持的平台包括：

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

cellpilot-mcp