AI导哈

Excel表格编辑工具

用于读取、写入、格式化和管理Excel表格的MCP服务器工具。

  • by nikhilwoodruff
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 nikhilwoodruff/xlsx

使用说明

MCP-XLSX

用于编辑XLSX文件的MCP服务器，提供读取、写入、格式化和管理Excel电子表格的工具。

快速入门（Claude 代码）

在你的用户目录下运行以下命令。

git clone https://github.com/nikhilwoodruff/xlsx && cd xlsx && uv pip install -e . && claude mcp add --transport stdio xlsx -- uv run mcp-xlsx

安装

uv pip install -e .

使用方法

与克劳德·科德一起

使用CLI添加MCP服务器：

claude mcp add --transport stdio xlsx -- uv run mcp-xlsx

或者创建一个 .mcp.json 项目中的文件：

{
  "mcpServers": {
    "xlsx": {
      "command": "uv",
      "args": ["run", "mcp-xlsx"]
    }
  }
}

使用 Claude Desktop

添加到您的Claude桌面配置中（例如。， ~/Library/Application Support/Claude/claude_desktop_config.json)：

{
  "mcpServers": {
    "xlsx": {
      "command": "uv",
      "args": ["run", "mcp-xlsx"]
    }
  }
}

或者如果全局安装：

{
  "mcpServers": {
    "xlsx": {
      "command": "mcp-xlsx"
    }
  }
}

可用的工具

读取_xlsx（文件）

从XLSX文件中读取数据。

参数：

  • file_path （必需）：XLSX 文件的路径
  • sheet_name （可选）：工作表名称（默认为当前活动工作表）
  • range （可选）：要读取的单元格范围（例如，“A1:C10”）。如果未指定，则读取整个工作表

write_xlsx 翻译为中文是“写入Excel文件（使用xlsx格式）”

将数据写入XLSX文件。如果文件不存在，则创建该文件。

参数：

  • file_path （必填）：XLSX 文件的路径
  • data （必需）：要写入的数据的二维数组（行和列）
  • sheet_name （可选）：工作表名称（如果不存在则创建）
  • start_cell （可选）：起始单元格（例如，“A1”）。默认为A1

更新单元格

更新特定单元格的值。

参数：

  • file_path （必填）：XLSX 文件的路径
  • cell （必填）：单元格引用（例如，'A1'，'B5'）
  • value （必需）：要设置的值（字符串、数字或布尔值）
  • sheet_name （可选）：工作表名称

格式化单元格

使用样式选项格式化单元格或单元格范围。

参数：

  • file_path （必需）：XLSX 文件的路径
  • cell_range （必填）：单元格或单元格范围（例如，'A1' 或 'A1:C10'）
  • sheet_name （可选）：工作表名称
  • bold （可选）：使文本加粗
  • italic （可选）：使文本变为斜体
  • font_size （可选）：以点为单位的字体大小
  • font_color （可选）：字体颜色的十六进制代码（例如，红色为'FF0000'）
  • bg_color （可选）：以十六进制表示的背景颜色（例如，'FFFF00' 表示黄色）
  • alignment （可选）：文本对齐方式：'左对齐'，'居中'，'右对齐'

列表工作表

列出XLSX文件中的所有工作表名称。

参数：

  • file_path （必需）：XLSX 文件的路径

创建工作表

在XLSX文件中创建一个新工作表。

参数：

  • file_path （必填）：XLSX 文件的路径
  • sheet_name （必填）：新工作表的名称

删除工作表

从XLSX文件中删除一个工作表。

参数：

  • file_path （必需）：XLSX 文件的路径
  • sheet_name （必填）：要删除的工作表的名称

示例用法

一旦在Claude Code或Claude Desktop中进行配置，您就可以要求Claude：

  • “从sales.xlsx中读取数据”
  • “创建一个名为budget.xlsx的新电子表格，包含以下列：月份、收入、支出”
  • “将 report.xlsx 文件中的 B2 单元格更新为 1000”
  • 将单元格A1:D1设置为黄色背景并加粗
  • “列出workbook.xlsx工作簿中的所有工作表”

发展

安装依赖项：

uv pip install -e .

格式代码：

ruff format src/

代码整洁度（或代码规范）：

ruff check src/

相关 MCP