excel

haris-musa
3390
Enables AI to create, read, and manipulate Excel files including formulas, charts, and pivot tables without requiring MS Excel installed.

Content

excel 29

A Model Context Protocol server for manipulating Excel files without Excel.

upload_excel_file

上传Excel文件到服务器进行处理 参数: - file_url: Excel文件的URL地址(支持 .xlsx, .xls 格式) 返回: - file_id: 文件唯一标识,后续操作时使用此ID 使用示例: upload_excel_file(file_url="https://example.com/data.xlsx")

Parameters (1)
file_url string Required

download_excel_file

下载处理完成的Excel文件,获取下载链接 参数: - file_id: 文件唯一标识(通过 upload_excel_file 或 create_workbook 获取) 返回: - 文件下载URL 使用示例: download_excel_file(file_id="a1b2c3d4")

Parameters (1)
file_id string Required

list_excel_files

列出当前用户所有缓存的Excel文件 返回: - 文件列表,包含 file_id 和文件信息 使用示例: list_excel_files()

No parameters required

delete_excel_file

删除指定的Excel文件 参数: - file_id: 要删除的文件ID 返回: - 删除结果 使用示例: delete_excel_file(file_id="a1b2c3d4")

Parameters (1)
file_id string Required

apply_formula

在单元格中应用Excel公式 参数: - file_id: 文件ID - sheet_name: 工作表名称 - cell: 单元格地址(如 "A1") - formula: Excel公式(如 "=SUM(A1:A10)") 返回: - 操作结果和file_id

Parameters (4)
file_id string Required

sheet_name string Required

cell string Required

formula string Required

validate_formula_syntax

验证Excel公式语法(不应用) 参数: - file_id: 文件ID - sheet_name: 工作表名称 - cell: 单元格地址 - formula: 要验证的公式

Parameters (4)
file_id string Required

sheet_name string Required

cell string Required

formula string Required

format_range

格式化单元格范围 参数: - file_id: 文件ID - sheet_name: 工作表名称 - start_cell: 起始单元格 - end_cell: 结束单元格(可选) - bold: 是否加粗 - italic: 是否斜体 - underline: 是否下划线 - font_size: 字体大小 - font_color: 字体颜色(如 "FF0000") - bg_color: 背景颜色 - border_style: 边框样式 - border_color: 边框颜色 - number_format: 数字格式 - alignment: 对齐方式 - wrap_text: 是否自动换行 - merge_cells: 是否合并单元格

Parameters (18)
file_id string Required

sheet_name string Required

start_cell string Required

end_cell string Optional

bold boolean Optional

italic boolean Optional

underline boolean Optional

font_size string Optional

font_color string Optional

bg_color string Optional

border_style string Optional

border_color string Optional

number_format string Optional

alignment string Optional

wrap_text boolean Optional

merge_cells boolean Optional

protection string Optional

conditional_format string Optional

read_data_from_excel

读取Excel工作表数据 参数: - file_id: 文件ID - sheet_name: 工作表名称 - start_cell: 起始单元格(默认 "A1") - end_cell: 结束单元格(可选,不提供则自动扩展) - preview_only: 是否只返回预览 返回: - JSON格式的单元格数据,包含地址、值、行、列和验证信息

Parameters (5)
file_id string Required

sheet_name string Required

start_cell string Optional

end_cell string Optional

preview_only boolean Optional

write_data_to_excel

写入数据到Excel工作表 参数: - file_id: 文件ID - sheet_name: 工作表名称 - data: 二维列表数据,子列表为行 - start_cell: 起始单元格(默认 "A1") 使用示例: write_data_to_excel( file_id="a1b2c3d4", sheet_name="Sheet1", data=[["姓名", "年龄"], ["张三", 25], ["李四", 30]], start_cell="A1" )

Parameters (4)
file_id string Required

sheet_name string Required

data array Required

start_cell string Optional

create_workbook

创建新的Excel工作簿 参数: - filename: 文件名(默认 "new_workbook.xlsx") 返回: - file_id: 新建文件的唯一标识 使用示例: create_workbook(filename="sales_report.xlsx") 创建完成,使用download_excel_file(file_id)工具,给用户返回下载地址。

Parameters (1)
filename string Optional

create_worksheet

在工作簿中创建新的工作表 参数: - file_id: 文件ID - sheet_name: 新工作表名称

Parameters (2)
file_id string Required

sheet_name string Required

create_chart

在工作表中创建图表 参数: - file_id: 文件ID - sheet_name: 工作表名称 - data_range: 数据范围(如 "A1:D10") - chart_type: 图表类型(bar, line, pie, scatter 等) - target_cell: 图表放置位置 - title: 图表标题 - x_axis: X轴标签 - y_axis: Y轴标签

Parameters (8)
file_id string Required

sheet_name string Required

data_range string Required

chart_type string Required

target_cell string Required

title string Optional

x_axis string Optional

y_axis string Optional

create_pivot_table

创建数据透视表 参数: - file_id: 文件ID - sheet_name: 工作表名称 - data_range: 数据范围 - rows: 行字段列表 - values: 值字段列表 - columns: 列字段列表(可选) - agg_func: 聚合函数(mean, sum, count 等)

Parameters (7)
file_id string Required

sheet_name string Required

data_range string Required

rows array Required

values array Required

columns string Optional

agg_func string Optional

create_table

从指定数据范围创建Excel表格 参数: - file_id: 文件ID - sheet_name: 工作表名称 - data_range: 数据范围 - table_name: 表格名称(可选) - table_style: 表格样式(默认 "TableStyleMedium9")

Parameters (5)
file_id string Required

sheet_name string Required

data_range string Required

table_name string Optional

table_style string Optional

copy_worksheet

复制工作表 参数: - file_id: 文件ID - source_sheet: 源工作表名称 - target_sheet: 目标工作表名称

Parameters (3)
file_id string Required

source_sheet string Required

target_sheet string Required

delete_worksheet

删除工作表 参数: - file_id: 文件ID - sheet_name: 要删除的工作表名称

Parameters (2)
file_id string Required

sheet_name string Required

rename_worksheet

重命名工作表 参数: - file_id: 文件ID - old_name: 原工作表名称 - new_name: 新工作表名称

Parameters (3)
file_id string Required

old_name string Required

new_name string Required

get_workbook_metadata

获取工作簿元数据,包括工作表列表、范围等信息 参数: - file_id: 文件ID - include_ranges: 是否包含范围信息

Parameters (2)
file_id string Required

include_ranges boolean Optional

merge_cells

合并单元格范围 参数: - file_id: 文件ID - sheet_name: 工作表名称 - start_cell: 起始单元格 - end_cell: 结束单元格

Parameters (4)
file_id string Required

sheet_name string Required

start_cell string Required

end_cell string Required

unmerge_cells

取消合并单元格 参数: - file_id: 文件ID - sheet_name: 工作表名称 - start_cell: 起始单元格 - end_cell: 结束单元格

Parameters (4)
file_id string Required

sheet_name string Required

start_cell string Required

end_cell string Required

get_merged_cells

获取工作表中所有合并的单元格 参数: - file_id: 文件ID - sheet_name: 工作表名称

Parameters (2)
file_id string Required

sheet_name string Required

copy_range

复制单元格范围到另一个位置 参数: - file_id: 文件ID - sheet_name: 源工作表名称 - source_start: 源范围起始单元格 - source_end: 源范围结束单元格 - target_start: 目标起始单元格 - target_sheet: 目标工作表名称(可选,默认为源工作表)

Parameters (6)
file_id string Required

sheet_name string Required

source_start string Required

source_end string Required

target_start string Required

target_sheet string Optional

delete_range

删除单元格范围并移动剩余单元格 参数: - file_id: 文件ID - sheet_name: 工作表名称 - start_cell: 起始单元格 - end_cell: 结束单元格 - shift_direction: 移动方向("up" 或 "left")

Parameters (5)
file_id string Required

sheet_name string Required

start_cell string Required

end_cell string Required

shift_direction string Optional

validate_excel_range

验证范围是否存在且格式正确 参数: - file_id: 文件ID - sheet_name: 工作表名称 - start_cell: 起始单元格 - end_cell: 结束单元格(可选)

Parameters (4)
file_id string Required

sheet_name string Required

start_cell string Required

end_cell string Optional

get_data_validation_info

获取工作表中所有数据验证规则 参数: - file_id: 文件ID - sheet_name: 工作表名称

Parameters (2)
file_id string Required

sheet_name string Required

insert_rows

插入行 参数: - file_id: 文件ID - sheet_name: 工作表名称 - start_row: 起始行号 - count: 插入行数(默认 1)

Parameters (4)
file_id string Required

sheet_name string Required

start_row integer Required

count integer Optional

insert_columns

插入列 参数: - file_id: 文件ID - sheet_name: 工作表名称 - start_col: 起始列号 - count: 插入列数(默认 1)

Parameters (4)
file_id string Required

sheet_name string Required

start_col integer Required

count integer Optional

delete_sheet_rows

删除行 参数: - file_id: 文件ID - sheet_name: 工作表名称 - start_row: 起始行号 - count: 删除行数(默认 1)

Parameters (4)
file_id string Required

sheet_name string Required

start_row integer Required

count integer Optional

delete_sheet_columns

删除列 参数: - file_id: 文件ID - sheet_name: 工作表名称 - start_col: 起始列号 - count: 删除列数(默认 1)

Parameters (4)
file_id string Required

sheet_name string Required

start_col integer Required

count integer Optional