baiyx-mcp-server-excel

读取Excel工作表中的数据 参数: file_path (str): Excel文件路径，例如："sales_2024.xlsx" sheet_name (str): 工作表名称，例如："Sheet1" range (str, optional): 要读取的单元格范围，例如："A1:E5" 返回: ExcelData: 包含数据和范围信息的对象

获取Excel工作簿的详细信息，包括所有工作表的信息 参数: file_path (str): Excel文件路径，例如："sales_2024.xlsx" 返回: WorkbookInfo: 工作簿信息对象 实际使用示例: ```python # 读取销售数据文件信息 workbook = get_workbook_info("sales_2024.xlsx") # 打印工作簿信息 print(f"文件路径: {workbook.file_path}") print(f"工作表数量: {len(workbook.sheets)}") # 遍历所有工作表 for sheet in workbook.sheets: print(f" 工作表: {sheet.name}") print(f"表头: {sheet.headers}") print(f"数据范围: {sheet.data_range}") print(f"行数: {sheet.row_count}") print(f"列数: {sheet.column_count}") ``` 输出示例: ``` 文件路径: sales_2024.xlsx 工作表数量: 2 工作表: Q1销售 表头: ['日期', '产品', '数量', '单价', '总价'] 数据范围: A1:E100 行数: 100 列数: 5 工作表: Q2销售 表头: ['日期', '产品', '数量', '单价', '总价'] 数据范围: A1:E150 行数: 150 列数: 5 ```

写入公式到Excel工作表 参数: file_path (str): Excel文件路径，例如："sales_2024.xlsx" sheet_name (str): 工作表名称，例如："Sheet1" range (str): 起始单元格，例如："F2" formulas (List[str]): 要写入的公式列表 返回: bool: 写入成功返回True，失败返回False

读取Excel工作表中的公式 参数: file_path (str): Excel文件路径，例如："sales_2024.xlsx" sheet_name (str): 工作表名称，例如："Q1销售" cell_range (str, optional): 要读取的单元格范围，例如："F2:F7" 返回: ExcelFormula: 包含公式列表和范围信息的对象 实际使用示例: ```python # 读取销售统计公式 formulas = read_sheet_formula("sales_2024.xlsx", "Q1销售", "F2:F7") # 打印公式 print("销售统计公式:") for formula in formulas.formulas: print(formula) print(f"公式范围: {formulas.range}") # 读取所有公式 all_formulas = read_sheet_formula("sales_2024.xlsx", "Q1销售") print(f" 总公式数: {len(all_formulas.formulas)}") ``` 输出示例: ``` 销售统计公式: =SUM(E2:E5) # 总销售额: 66935.00 =AVERAGE(E2:E5) # 平均订单金额: 16733.75 =COUNTIF(B2:B5,"键盘") # 键盘销售次数: 1 =SUMIF(B2:B5,"显示器",E2:E5) # 显示器销售总额: 19990.00 =MAX(E2:E5) # 最大订单金额: 34995.00 =MIN(E2:E5) # 最小订单金额: 5970.00 公式范围: F2:F7 总公式数: 6 ```

写入数据到Excel工作表 参数: file_path (str): Excel文件路径，例如："sales_2024.xlsx" sheet_name (str): 工作表名称，例如："Q1销售" start_cell (str): 起始单元格，例如："A1" data (List[List[Any]]): 要写入的二维数组数据 返回: bool: 写入成功返回True，失败抛出异常 实际使用示例: ```python # 准备销售数据 sales_data = [ ["日期", "产品", "数量", "单价", "总价"], ["2024-03-01", "笔记本电脑", 5, 6999.00, "=C2*D2"], ["2024-03-01", "显示器", 10, 1999.00, "=C3*D3"], ["2024-03-02", "键盘", 20, 299.00, "=C4*D4"], ["2024-03-02", "鼠标", 30, 199.00, "=C5*D5"] ] # 写入数据 success = write_sheet_data("sales_2024.xlsx", "Q1销售", "A1", sales_data) if success: print("数据写入成功！") print("写入的数据:") for row in sales_data: print(row) ``` 输出示例: ``` 数据写入成功！ 写入的数据: ['日期', '产品', '数量', '单价', '总价'] ['2024-03-01', '笔记本电脑', 5, 6999.00, '=C2*D2'] ['2024-03-01', '显示器', 10, 1999.00, '=C3*D3'] ['2024-03-02', '键盘', 20, 299.00, '=C4*D4'] ['2024-03-02', '鼠标', 30, 199.00, '=C5*D5'] ```