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/