@tanskong/office-mcp 1.0.0

package/bin/office-mcp.js

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+
+const { spawn } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+
+const scriptPath = path.join(__dirname, '..', 'src', 'office_server.py');
+
+if (!fs.existsSync(scriptPath)) {
+    console.error('Error: office_server.py not found');
+    process.exit(1);
+}
+
+const python = process.platform === 'win32' ? 'python' : 'python3';
+
+const proc = spawn(python, [scriptPath], {
+    cwd: path.join(__dirname, '..', 'src'),
+    stdio: 'inherit'
+});
+
+proc.on('close', (code) => {
+    process.exit(code);
+});

package/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "@tanskong/office-mcp",
+  "version": "1.0.0",
+  "description": "Excel实时办公助手 MCP服务器",
+  "bin": {
+    "office-mcp": "./bin/office-mcp.js"
+  },
+  "scripts": {
+    "start": "node bin/office-mcp.js"
+  },
+  "engines": {
+    "node": ">=16"
+  },
+  "keywords": ["mcp", "excel", "office", "trae"],
+  "author": "",
+  "license": "MIT"
+}

package/src/office_server.py

@@ -0,0 +1,995 @@
+#!/usr/bin/env python3
+"""
+Office MCP Server - Real-time Excel Control
+使用FastMCP协议，支持实时读写Excel数据
+"""
+
+import json
+import sys
+import os
+from pathlib import Path
+
+import importlib.metadata
+orig_version = importlib.metadata.version
+importlib.metadata.version = lambda name: "3.1.1" if name == "fastmcp" else orig_version(name)
+
+try:
+    from fastmcp import FastMCP
+    FASTMCP_AVAILABLE = True
+except Exception as e:
+    FASTMCP_AVAILABLE = False
+    print(f"ERROR: Failed to import fastmcp: {e}", file=sys.stderr)
+    sys.exit(1)
+
+MCP = FastMCP("Office Server")
+
+def run_mcp():
+    MCP.run(transport="stdio")
+
+def show_window(icon, item):
+    import win32api
+    import win32con
+    guide_text = """
+📖 快速指南：
+• 双击运行 exe → 托盘出现绿色图标 → 在 Trae 中发送指令 → Excel 自动操作！
+• 配置 Trae（只需一次）：打开 Trae → 设置 → MCP 配置 → 添加服务器 → 填入文件夹路径
+• 重要原则：✅ 用 IDE 模式，不是 Solo 模式  ✅ Excel在打开状态也能使用，实时互动  ✅ 绿色图标亮着表示 MCP 在运行
+• 常用指令：帮我读取表格 / 在第二行插入一行 / 帮我把 A1 单元格标红
+• 配置模板：command: python, args: ["你的路径\\office_server.py"], cwd: "你的路径"
+• 完整说明请看《学员使用手册.md》
+"""
+    win32api.MessageBox(0, f"Office MCP Server v2.1\n\n服务器正在运行中...\n\n关闭此窗口可停止服务器{guide_text}", "MCP Server", win32con.MB_OK)
+
+# Excel COM interface
+def get_excel_app():
+    """获取已打开的Excel应用实例"""
+    import win32com.client
+    import pythoncom
+    pythoncom.CoInitialize()
+    
+    # Dispatch会连接到已打开的Excel，如果没有则新建
+    app = win32com.client.Dispatch("Excel.Application")
+    app.Visible = True
+    app.DisplayAlerts = False
+    return app
+
+def get_active_workbook(app):
+    """获取当前活动工作簿"""
+    try:
+        # Excel: Workbooks, WPS: Workbooks (same)
+        wb = app.ActiveWorkbook
+    except:
+        try:
+            # WPS可能用这个
+            wb = app.ActiveWorkbook
+        except:
+            raise Exception("无法获取活动工作簿，请确保Excel/WPS已打开文件")
+    
+    if wb is None:
+        raise Exception("No active workbook. Please open an Excel file first.")
+    return wb
+
+# ==================== VBA 相关工具 ====================
+
+@MCP.tool()
+def read_vba_code(module_name: str = None):
+    """
+    读取VBA代码
+    参数: module_name - 可选，模块名称。不指定则读取所有模块
+    返回: VBA代码内容
+    """
+    try:
+        app = get_excel_app()
+        wb = get_active_workbook(app)
+        vba_project = wb.VBProject
+
+        if module_name:
+            for component in vba_project.VBComponents:
+                if component.Name == module_name:
+                    code = component.CodeModule.Lines(1, component.CodeModule.CountOfLines)
+                    return {"success": True, "module": module_name, "code": code}
+            return {"success": False, "error": f"Module '{module_name}' not found"}
+        else:
+            modules = {}
+            for component in vba_project.VBComponents:
+                if component.Type in [1, 2, 3]:  # StdModule, ClassModule, MSForm
+                    name = component.Name
+                    code = component.CodeModule.Lines(1, component.CodeModule.CountOfLines)
+                    modules[name] = code
+            return {"success": True, "modules": modules}
+    except Exception as e:
+        return {"success": False, "error": str(e)}
+
+@MCP.tool()
+def write_vba_code(module_name: str, code: str):
+    """
+    写入VBA代码
+    参数: module_name - 模块名称, code - VBA代码内容
+    返回: 操作结果
+    """
+    try:
+        app = get_excel_app()
+        wb = get_active_workbook(app)
+        vba_project = wb.VBProject
+
+        target_component = None
+        for component in vba_project.VBComponents:
+            if component.Name == module_name:
+                target_component = component
+                break
+
+        if target_component is None:
+            target_component = vba_project.VBComponents.Add(1)  # vbext_ct_StdModule
+            target_component.Name = module_name
+
+        code_module = target_component.CodeModule
+        if code_module.CountOfLines > 0:
+            code_module.DeleteLines(1, code_module.CountOfLines)
+
+        code_module.AddFromString(code)
+
+        return {"success": True, "message": f"VBA code written to module '{module_name}'"}
+    except Exception as e:
+        return {"success": False, "error": str(e)}
+
+@MCP.tool()
+def list_vba_modules():
+    """
+    列出所有VBA模块
+    返回: 模块列表
+    """
+    try:
+        app = get_excel_app()
+        wb = get_active_workbook(app)
+        vba_project = wb.VBProject
+
+        modules = []
+        for component in vba_project.VBComponents:
+            module_info = {
+                "name": component.Name,
+                "type": component.Type,
+                "lines": component.CodeModule.CountOfLines
+            }
+            modules.append(module_info)
+
+        return {"success": True, "modules": modules}
+    except Exception as e:
+        return {"success": False, "error": str(e)}
+
+@MCP.tool()
+def execute_vba_macro(macro_name: str):
+    """
+    运行VBA宏
+    参数: macro_name - 宏名称
+    返回: 执行结果
+    """
+    try:
+        app = get_excel_app()
+        wb = get_active_workbook(app)
+
+        if "." in macro_name:
+            wb.Application.Run(macro_name)
+        else:
+            wb.Application.Run(macro_name)
+
+        return {"success": True, "message": f"Macro '{macro_name}' executed successfully"}
+    except Exception as e:
+        return {"success": False, "error": str(e)}
+
+# ==================== Excel 数据操作工具 ====================
+
+@MCP.tool()
+def get_excel_data(sheet_name: str = None, range_address: str = None):
+    """
+    获取Excel数据
+    参数: sheet_name - 工作表名称(可选), range_address - 范围如"A1:B10"(可选)
+    返回: 表格数据
+    """
+    try:
+        app = get_excel_app()
+        wb = get_active_workbook(app)
+
+        if sheet_name:
+            ws = wb.Worksheets(sheet_name)
+        else:
+            ws = wb.ActiveSheet
+
+        if range_address:
+            data = ws.Range(range_address).Value
+        else:
+            data = ws.UsedRange.Value
+
+        return {"success": True, "data": data, "sheet": ws.Name}
+    except Exception as e:
+        return {"success": False, "error": str(e)}
+
+@MCP.tool()
+def set_excel_data(sheet_name: str, range_address: str, data):
+    """
+    设置Excel数据
+    参数: sheet_name - 工作表名称, range_address - 范围如"A1", data - 要写入的数据
+    返回: 操作结果
+    """
+    try:
+        app = get_excel_app()
+        wb = get_active_workbook(app)
+
+        if sheet_name:
+            ws = wb.Worksheets(sheet_name)
+        else:
+            ws = wb.ActiveSheet
+
+        ws.Range(range_address).Value = data
+        wb.Save()
+
+        return {"success": True, "message": f"Data written to {sheet_name}!{range_address}"}
+    except Exception as e:
+        return {"success": False, "error": str(e)}
+
+@MCP.tool()
+def get_workbook_info():
+    """
+    获取工作簿信息
+    返回: 工作簿名称、路径、工作表列表
+    """
+    try:
+        app = get_excel_app()
+        wb = get_active_workbook(app)
+
+        sheets = []
+        for ws in wb.Worksheets:
+            sheets.append({
+                "name": ws.Name,
+                "rows": ws.UsedRange.Rows.Count,
+                "columns": ws.UsedRange.Columns.Count
+            })
+
+        return {
+            "success": True,
+            "workbook": {
+                "name": wb.Name,
+                "path": wb.FullName,
+                "sheets": sheets
+            }
+        }
+    except Exception as e:
+        return {"success": False, "error": str(e)}
+
+@MCP.tool()
+def create_formula(sheet_name: str, cell: str, formula: str):
+    """
+    创建Excel公式
+    参数: sheet_name - 工作表名称, cell - 单元格如"A1", formula - 公式如"=SUM(B1:B10)"
+    返回: 操作结果
+    """
+    try:
+        app = get_excel_app()
+        wb = get_active_workbook(app)
+
+        if sheet_name:
+            ws = wb.Worksheets(sheet_name)
+        else:
+            ws = wb.ActiveSheet
+
+        ws.Range(cell).Formula = formula
+        wb.Save()
+
+        return {"success": True, "message": f"Formula '{formula}' set at {cell}"}
+    except Exception as e:
+        return {"success": False, "error": str(e)}
+
+@MCP.tool()
+def add_new_sheet(sheet_name: str):
+    """
+    添加新工作表
+    参数: sheet_name - 新工作表名称
+    返回: 操作结果
+    """
+    try:
+        app = get_excel_app()
+        wb = get_active_workbook(app)
+
+        ws = wb.Worksheets.Add()
+        ws.Name = sheet_name
+        wb.Save()
+
+        return {"success": True, "message": f"Sheet '{sheet_name}' created"}
+    except Exception as e:
+        return {"success": False, "error": str(e)}
+
+@MCP.tool()
+def delete_sheet(sheet_name: str):
+    """
+    删除工作表
+    参数: sheet_name - 要删除的工作表名称
+    返回: 操作结果
+    """
+    try:
+        app = get_excel_app()
+        wb = get_active_workbook(app)
+
+        wb.Worksheets(sheet_name).Delete()
+        wb.Save()
+
+        return {"success": True, "message": f"Sheet '{sheet_name}' deleted"}
+    except Exception as e:
+        return {"success": False, "error": str(e)}
+
+@MCP.tool()
+def read_cell(sheet_name: str, cell: str):
+    """
+    读取单元格
+    参数: sheet_name - 工作表名称, cell - 单元格如"A1"
+    返回: 单元格值
+    """
+    try:
+        app = get_excel_app()
+        wb = get_active_workbook(app)
+
+        if sheet_name:
+            ws = wb.Worksheets(sheet_name)
+        else:
+            ws = wb.ActiveSheet
+
+        value = ws.Range(cell).Value
+        formula = ws.Range(cell).Formula
+
+        return {"success": True, "cell": cell, "value": value, "formula": formula}
+    except Exception as e:
+        return {"success": False, "error": str(e)}
+
+@MCP.tool()
+def write_cell(sheet_name: str, cell: str, value):
+    """
+    写入单元格
+    参数: sheet_name - 工作表名称, cell - 单元格如"A1", value - 要写入的值
+    返回: 操作结果
+    """
+    try:
+        app = get_excel_app()
+        wb = get_active_workbook(app)
+
+        if sheet_name:
+            ws = wb.Worksheets(sheet_name)
+        else:
+            ws = wb.ActiveSheet
+
+        ws.Range(cell).Value = value
+
+        return {"success": True, "message": f"Value '{value}' written to {cell}"}
+    except Exception as e:
+        return {"success": False, "error": str(e)}
+
+@MCP.tool()
+def save_workbook():
+    """
+    保存当前工作簿
+    返回: 操作结果
+    """
+    try:
+        app = get_excel_app()
+        wb = get_active_workbook(app)
+        wb.Save()
+        return {"success": True, "message": "Workbook saved"}
+    except Exception as e:
+        return {"success": False, "error": str(e)}
+
+@MCP.tool()
+def set_cell_color(sheet_name: str, cell: str, color: str):
+    """
+    设置单元格背景颜色
+    参数: sheet_name - 工作表名称, cell - 单元格如"A1", color - 颜色如"red"或"#FF0000"
+    返回: 操作结果
+    """
+    try:
+        app = get_excel_app()
+        wb = get_active_workbook(app)
+
+        if sheet_name:
+            ws = wb.Worksheets(sheet_name)
+        else:
+            ws = wb.ActiveSheet
+
+        color_map = {
+            "red": 3, "green": 4, "blue": 5, "yellow": 6,
+            "purple": 7, "cyan": 8, "magenta": 13,
+            "orange": 46, "gray": 15, "white": 2, "black": 1
+        }
+
+        if color.startswith("#"):
+            ws.Range(cell).Interior.Color = color
+        elif color.lower() in color_map:
+            ws.Range(cell).Interior.ColorIndex = color_map[color.lower()]
+        else:
+            ws.Range(cell).Interior.Color = color
+
+        wb.Save()
+        return {"success": True, "message": f"Cell {cell} color set to {color}"}
+    except Exception as e:
+        return {"success": False, "error": str(e)}
+
+@MCP.tool()
+def set_cell_font_color(sheet_name: str, cell: str, color: str):
+    """
+    设置单元格字体颜色
+    参数: sheet_name - 工作表名称, cell - 单元格如"A1", color - 颜色如"red"或"#FF0000"
+    返回: 操作结果
+    """
+    try:
+        app = get_excel_app()
+        wb = get_active_workbook(app)
+
+        if sheet_name:
+            ws = wb.Worksheets(sheet_name)
+        else:
+            ws = wb.ActiveSheet
+
+        if color.startswith("#"):
+            ws.Range(cell).Font.Color = color
+        else:
+            color_map = {
+                "red": 255, "green": 65280, "blue": 16711680,
+                "yellow": 65535, "black": 0, "white": 16777215
+            }
+            ws.Range(cell).Font.Color = color_map.get(color.lower(), 0)
+
+        wb.Save()
+        return {"success": True, "message": f"Cell {cell} font color set to {color}"}
+    except Exception as e:
+        return {"success": False, "error": str(e)}
+
+@MCP.tool()
+def set_cell_bold(sheet_name: str, cell: str, bold: bool = True):
+    """
+    设置单元格字体粗体
+    参数: sheet_name - 工作表名称, cell - 单元格如"A1", bold - 是否粗体
+    返回: 操作结果
+    """
+    try:
+        app = get_excel_app()
+        wb = get_active_workbook(app)
+
+        if sheet_name:
+            ws = wb.Worksheets(sheet_name)
+        else:
+            ws = wb.ActiveSheet
+
+        ws.Range(cell).Font.Bold = bold
+
+        wb.Save()
+        return {"success": True, "message": f"Cell {cell} bold set to {bold}"}
+    except Exception as e:
+        return {"success": False, "error": str(e)}
+
+@MCP.tool()
+def extract_images_from_sheet(sheet_name: str = None, output_folder: str = None):
+    """
+    提取Excel中的图片
+    参数: sheet_name - 工作表名称(可选), output_folder - 输出文件夹(可选，默认当前目录)
+    返回: 提取的图片列表
+    """
+    try:
+        import os
+        import uuid
+        
+        app = get_excel_app()
+        wb = get_active_workbook(app)
+
+        if sheet_name:
+            ws = wb.Worksheets(sheet_name)
+        else:
+            ws = wb.ActiveSheet
+
+        if output_folder is None:
+            output_folder = os.path.dirname(wb.FullName)
+            if not output_folder:
+                output_folder = os.getcwd()
+
+        if not os.path.exists(output_folder):
+            os.makedirs(output_folder)
+
+        extracted = []
+        shapes = ws.Shapes
+        
+        for i in range(1, shapes.Count + 1):
+            shape = shapes.Item(i)
+            if shape.Type == 11 or shape.Type == 13:  # msoPicture or linked picture
+                name = f"image_{uuid.uuid4().hex[:8]}"
+                try:
+                    shape.CopyPicture(1, 2)  # xlScreen, xlBitmap
+                    
+                    if app.ActiveSheet.Paste().Count > 0:
+                        img_path = os.path.join(output_folder, f"{name}.png")
+                        app.ActiveChart.Export(img_path)
+                        extracted.append({"name": name, "path": img_path})
+                except Exception as e:
+                    pass
+
+        if extracted:
+            return {"success": True, "images": extracted, "count": len(extracted)}
+        else:
+            return {"success": False, "error": "No images found in sheet"}
+    except Exception as e:
+        return {"success": False, "error": str(e)}
+
+@MCP.tool()
+def list_sheet_images(sheet_name: str = None):
+    """
+    列出工作表中的图片
+    参数: sheet_name - 工作表名称(可选)
+    返回: 图片列表
+    """
+    try:
+        app = get_excel_app()
+        wb = get_active_workbook(app)
+
+        if sheet_name:
+            ws = wb.Worksheets(sheet_name)
+        else:
+            ws = wb.ActiveSheet
+
+        images = []
+        shapes = ws.Shapes
+        
+        for i in range(1, shapes.Count + 1):
+            shape = shapes.Item(i)
+            if shape.Type == 11 or shape.Type == 13:  # msoPicture or linked picture
+                images.append({
+                    "name": shape.Name,
+                    "type": shape.Type,
+                    "left": shape.Left,
+                    "top": shape.Top,
+                    "width": shape.Width,
+                    "height": shape.Height
+                })
+
+        return {"success": True, "images": images, "count": len(images)}
+    except Exception as e:
+        return {"success": False, "error": str(e)}
+
+@MCP.tool()
+def extract_images_from_excel(workbook_path: str = None, output_folder: str = None):
+    """
+    从Excel内部提取图片（更稳定的方式）
+    参数: workbook_path - 工作簿路径(可选，默认当前工作簿), output_folder - 输出文件夹(可选，默认当前目录)
+    返回: 提取的图片列表
+    """
+    try:
+        import zipfile
+        import shutil
+        import tempfile
+
+        app = get_excel_app()
+        wb = get_active_workbook(app)
+
+        if workbook_path is None:
+            workbook_path = wb.FullName
+
+        if output_folder is None:
+            output_folder = os.path.dirname(workbook_path)
+            if not output_folder:
+                output_folder = os.getcwd()
+
+        output_folder = os.path.join(output_folder, "extracted_images")
+        os.makedirs(output_folder, exist_ok=True)
+
+        temp_dir = tempfile.mkdtemp()
+        try:
+            with zipfile.ZipFile(workbook_path, 'r') as zip_ref:
+                zip_ref.extractall(temp_dir)
+
+            media_dir = os.path.join(temp_dir, 'xl', 'media')
+            if not os.path.exists(media_dir):
+                return {"success": False, "error": "No media folder found in Excel"}
+
+            images = []
+            for filename in os.listdir(media_dir):
+                if filename.lower().endswith(('.png', '.jpg', '.jpeg', '.gif', '.bmp')):
+                    src = os.path.join(media_dir, filename)
+                    dst = os.path.join(output_folder, filename)
+                    shutil.copy2(src, dst)
+                    images.append({
+                        "name": filename,
+                        "path": dst
+                    })
+
+            return {"success": True, "images": images, "count": len(images), "output_folder": output_folder}
+        finally:
+            shutil.rmtree(temp_dir, ignore_errors=True)
+    except Exception as e:
+        return {"success": False, "error": str(e)}
+
+@MCP.tool()
+def delete_sheet_image(sheet_name: str, image_index: int = None, image_name: str = None):
+    """
+    删除工作表中的图片
+    参数: sheet_name - 工作表名称, image_index - 图片索引(从1开始), image_name - 图片名称(二选一)
+    返回: 操作结果
+    """
+    try:
+        app = get_excel_app()
+        wb = get_active_workbook(app)
+        ws = wb.Worksheets(sheet_name)
+
+        shapes = ws.Shapes
+        target_shape = None
+
+        if image_name:
+            for i in range(1, shapes.Count + 1):
+                shape = shapes.Item(i)
+                if shape.Name == image_name:
+                    target_shape = shape
+                    break
+        elif image_index:
+            if 1 <= image_index <= shapes.Count:
+                target_shape = shapes.Item(image_index)
+
+        if target_shape:
+            target_shape.Delete()
+            wb.Save()
+            return {"success": True, "message": f"Deleted image: {target_shape.Name}"}
+        else:
+            return {"success": False, "error": "Image not found"}
+    except Exception as e:
+        return {"success": False, "error": str(e)}
+
+# ==================== 批量操作工具 ====================
+
+@MCP.tool()
+def batch_write_cells(sheet_name: str, cells: list):
+    """
+    批量写入多个单元格
+    参数: sheet_name - 工作表名称, cells - 单元格列表，格式如[{"cell": "A1", "value": "值1"}, {"cell": "B1", "value": "值2"}]
+    返回: 操作结果
+    """
+    try:
+        app = get_excel_app()
+        wb = get_active_workbook(app)
+
+        if sheet_name:
+            ws = wb.Worksheets(sheet_name)
+        else:
+            ws = wb.ActiveSheet
+
+        success_count = 0
+        for item in cells:
+            cell = item.get("cell")
+            value = item.get("value")
+            if cell and value is not None:
+                ws.Range(cell).Value = value
+                success_count += 1
+
+        wb.Save()
+        return {"success": True, "message": f"Written {success_count} cells"}
+    except Exception as e:
+        return {"success": False, "error": str(e)}
+
+@MCP.tool()
+def batch_set_colors(sheet_name: str, cells: list):
+    """
+    批量设置单元格颜色
+    参数: sheet_name - 工作表名称, cells - 单元格列表，格式如[{"cell": "A1", "color": "red"}, {"cell": "B1", "color": "yellow"}]
+    返回: 操作结果
+    """
+    try:
+        app = get_excel_app()
+        wb = get_active_workbook(app)
+
+        if sheet_name:
+            ws = wb.Worksheets(sheet_name)
+        else:
+            ws = wb.ActiveSheet
+
+        color_map = {
+            "red": 3, "green": 4, "blue": 5, "yellow": 6,
+            "purple": 7, "cyan": 8, "magenta": 13,
+            "orange": 46, "gray": 15, "white": 2, "black": 1
+        }
+
+        success_count = 0
+        for item in cells:
+            cell = item.get("cell")
+            color = item.get("color")
+            if cell and color:
+                if color.startswith("#"):
+                    ws.Range(cell).Interior.Color = color
+                elif color.lower() in color_map:
+                    ws.Range(cell).Interior.ColorIndex = color_map[color.lower()]
+                else:
+                    ws.Range(cell).Interior.Color = color
+                success_count += 1
+
+        wb.Save()
+        return {"success": True, "message": f"Colored {success_count} cells"}
+    except Exception as e:
+        return {"success": False, "error": str(e)}
+
+@MCP.tool()
+def batch_write_rows(sheet_name: str, start_row: int, data: list):
+    """
+    批量写入多行数据
+    参数: sheet_name - 工作表名称, start_row - 起始行号, data - 数据列表，如[["A1","B1","C1"], ["A2","B2","C2"]]
+    返回: 操作结果
+    """
+    try:
+        app = get_excel_app()
+        wb = get_active_workbook(app)
+
+        if sheet_name:
+            ws = wb.Worksheets(sheet_name)
+        else:
+            ws = wb.ActiveSheet
+
+        for i, row_data in enumerate(data):
+            row_num = start_row + i
+            for j, value in enumerate(row_data):
+                col_letter = chr(65 + j)  # A, B, C...
+                ws.Range(f"{col_letter}{row_num}").Value = value
+
+        wb.Save()
+        return {"success": True, "message": f"Written {len(data)} rows"}
+    except Exception as e:
+        return {"success": False, "error": str(e)}
+
+@MCP.tool()
+def batch_create_formulas(sheet_name: str, formulas: list):
+    """
+    批量创建公式
+    参数: sheet_name - 工作表名称, formulas - 公式列表，格式如[{"cell": "C1", "formula": "=A1+B1"}, {"cell": "C2", "formula": "=A2+B2"}]
+    返回: 操作结果
+    """
+    try:
+        app = get_excel_app()
+        wb = get_active_workbook(app)
+
+        if sheet_name:
+            ws = wb.Worksheets(sheet_name)
+        else:
+            ws = wb.ActiveSheet
+
+        success_count = 0
+        for item in formulas:
+            cell = item.get("cell")
+            formula = item.get("formula")
+            if cell and formula:
+                ws.Range(cell).Formula = formula
+                success_count += 1
+
+        wb.Save()
+        return {"success": True, "message": f"Created {success_count} formulas"}
+    except Exception as e:
+        return {"success": False, "error": str(e)}
+
+@MCP.tool()
+def insert_rows(sheet_name: str, row: int, count: int = 1):
+    """
+    插入行
+    参数: sheet_name - 工作表名称, row - 插入位置, count - 插入行数
+    返回: 操作结果
+    """
+    try:
+        app = get_excel_app()
+        wb = get_active_workbook(app)
+
+        if sheet_name:
+            ws = wb.Worksheets(sheet_name)
+        else:
+            ws = wb.ActiveSheet
+
+        ws.Rows(f"{row}:{row + count - 1}").Insert(-4161)  # xlShiftDown
+
+        wb.Save()
+        return {"success": True, "message": f"Inserted {count} rows at row {row}"}
+    except Exception as e:
+        return {"success": False, "error": str(e)}
+
+@MCP.tool()
+def delete_rows(sheet_name: str, row: int, count: int = 1):
+    """
+    删除行
+    参数: sheet_name - 工作表名称, row - 删除起始行, count - 删除行数
+    返回: 操作结果
+    """
+    try:
+        app = get_excel_app()
+        wb = get_active_workbook(app)
+
+        if sheet_name:
+            ws = wb.Worksheets(sheet_name)
+        else:
+            ws = wb.ActiveSheet
+
+        ws.Rows(f"{row}:{row + count - 1}").Delete()
+
+        wb.Save()
+        return {"success": True, "message": f"Deleted {count} rows from row {row}"}
+    except Exception as e:
+        return {"success": False, "error": str(e)}
+
+@MCP.tool()
+def insert_columns(sheet_name: str, column: str, count: int = 1):
+    """
+    插入列
+    参数: sheet_name - 工作表名称, column - 列字母如"A", count - 插入列数
+    返回: 操作结果
+    """
+    try:
+        app = get_excel_app()
+        wb = get_active_workbook(app)
+
+        if sheet_name:
+            ws = wb.Worksheets(sheet_name)
+        else:
+            ws = wb.ActiveSheet
+
+        ws.Columns(f"{column}:{chr(ord(column) + count - 1)}").Insert(-4161)  # xlShiftRight
+
+        wb.Save()
+        return {"success": True, "message": f"Inserted {count} columns at {column}"}
+    except Exception as e:
+        return {"success": False, "error": str(e)}
+
+@MCP.tool()
+def delete_columns(sheet_name: str, column: str, count: int = 1):
+    """
+    删除列
+    参数: sheet_name - 工作表名称, column - 列字母如"A", count - 删除列数
+    返回: 操作结果
+    """
+    try:
+        app = get_excel_app()
+        wb = get_active_workbook(app)
+
+        if sheet_name:
+            ws = wb.Worksheets(sheet_name)
+        else:
+            ws = wb.ActiveSheet
+
+        ws.Columns(f"{column}:{chr(ord(column) + count - 1)}").Delete()
+
+        wb.Save()
+        return {"success": True, "message": f"Deleted {count} columns from {column}"}
+    except Exception as e:
+        return {"success": False, "error": str(e)}
+
+@MCP.tool()
+def set_column_width(sheet_name: str, column: str, width: float):
+    """
+    设置列宽
+    参数: sheet_name - 工作表名称, column - 列字母如"A", width - 宽度
+    返回: 操作结果
+    """
+    try:
+        app = get_excel_app()
+        wb = get_active_workbook(app)
+
+        if sheet_name:
+            ws = wb.Worksheets(sheet_name)
+        else:
+            ws = wb.ActiveSheet
+
+        ws.Columns(column).ColumnWidth = width
+
+        wb.Save()
+        return {"success": True, "message": f"Column {column} width set to {width}"}
+    except Exception as e:
+        return {"success": False, "error": str(e)}
+
+@MCP.tool()
+def set_row_height(sheet_name: str, row: int, height: float):
+    """
+    设置行高
+    参数: sheet_name - 工作表名称, row - 行号, height - 高度
+    返回: 操作结果
+    """
+    try:
+        app = get_excel_app()
+        wb = get_active_workbook(app)
+
+        if sheet_name:
+            ws = wb.Worksheets(sheet_name)
+        else:
+            ws = wb.ActiveSheet
+
+        ws.Rows(row).RowHeight = height
+
+        wb.Save()
+        return {"success": True, "message": f"Row {row} height set to {height}"}
+    except Exception as e:
+        return {"success": False, "error": str(e)}
+
+@MCP.tool()
+def merge_cells(sheet_name: str, range_address: str):
+    """
+    合并单元格
+    参数: sheet_name - 工作表名称, range_address - 范围如"A1:D1"
+    返回: 操作结果
+    """
+    try:
+        app = get_excel_app()
+        wb = get_active_workbook(app)
+
+        if sheet_name:
+            ws = wb.Worksheets(sheet_name)
+        else:
+            ws = wb.ActiveSheet
+
+        ws.Range(range_address).Merge()
+
+        wb.Save()
+        return {"success": True, "message": f"Merged cells {range_address}"}
+    except Exception as e:
+        return {"success": False, "error": str(e)}
+
+@MCP.tool()
+def unmerge_cells(sheet_name: str, range_address: str):
+    """
+    取消合并单元格
+    参数: sheet_name - 工作表名称, range_address - 范围如"A1:D1"
+    返回: 操作结果
+    """
+    try:
+        app = get_excel_app()
+        wb = get_active_workbook(app)
+
+        if sheet_name:
+            ws = wb.Worksheets(sheet_name)
+        else:
+            ws = wb.ActiveSheet
+
+        ws.Range(range_address).UnMerge()
+
+        wb.Save()
+        return {"success": True, "message": f"Unmerged cells {range_address}"}
+    except Exception as e:
+        return {"success": False, "error": str(e)}
+
+if __name__ == "__main__":
+    import threading
+    import time
+
+    def run_mcp():
+        MCP.run()
+
+    def show_window(icon, item):
+        import win32api
+        import win32con
+        guide_path = Path(__file__).parent / "快速指南.md"
+        guide_text = ""
+        if guide_path.exists():
+            guide_text = "\n\n📖 快速指南：\n" + guide_path.read_text(encoding="utf-8").split("---")[0] if "---" in guide_path.read_text(encoding="utf-8") else ""
+        win32api.MessageBox(0, f"Office MCP Server v2.1\n\n服务器正在运行中...\n\n关闭此窗口可停止服务器{guide_text}", "MCP Server", win32con.MB_OK)
+
+    def quit_app(icon, item):
+        import os
+        os._exit(0)
+    
+    try:
+        import pystray
+        from PIL import Image, ImageDraw
+        
+        width = 64
+        height = 64
+        image = Image.new('RGB', (width, height), color='#4CAF50')
+        draw = ImageDraw.Draw(image)
+        draw.rectangle([8, 8, 56, 56], fill='white', outline='#4CAF50', width=3)
+        draw.text((20, 22), 'MCP', fill='#4CAF50')
+        
+        menu = pystray.Menu(
+            pystray.MenuItem("MCP服务器运行中", show_window, default=True),
+            pystray.MenuItem("退出", quit_app)
+        )
+        
+        icon = pystray.Icon("office_mcp", image, "Office MCP Server", menu)
+        
+        mcp_thread = threading.Thread(target=run_mcp, daemon=True)
+        mcp_thread.start()
+        
+        print("Office MCP Server v2.1 已启动！（托盘图标运行）")
+        print("双击托盘图标查看状态，点击退出关闭服务器")
+        
+        icon.run()
+    except Exception as e:
+        print(f"托盘模式启动失败: {e}")
+        print("使用备用模式...")
+        run_mcp()

package/src//346/231/272/350/203/275/344/275/223/346/217/217/350/277/260.md

@@ -0,0 +1,154 @@
+# Office 智能体配置指南
+
+## 智能体名称
+**Excel实时办公助手**
+
+## 智能体描述
+
+你是一个专业的Excel办公助手，专注于帮助用户高效完成日常办公任务。
+
+## 核心能力
+
+你有一个强大的MCP工具集（Office MCP），可以：
+- ✅ 直接操作Excel数据
+- ✅ 提取Excel中的图片
+
+## ⚠️ 重要原则
+
+1. **首先确认工作簿**：每次操作前，调用 get_workbook_info
+
+2. **优先用MCP工具**：
+   - 读取数据：用 get_excel_data、read_cell
+   - 写入数据：用 batch_write_cells（批量）、batch_write_rows（批量行）
+   - 设置颜色：用 batch_set_colors（批量）
+   - 设置字体：用 set_cell_font_color、set_cell_bold
+   - 创建公式：用 batch_create_formulas（批量）
+   - 管理工作表：用 add_new_sheet、delete_sheet
+   - 插入/删除：用 insert_rows、delete_rows、insert_columns、delete_columns
+   - 行列调整：用 set_column_width、set_row_height
+   - 合并单元格：用 merge_cells、unmerge_cells
+   - 提取图片：用 extract_images_from_sheet（优先）或从Excel内部提取
+   - 删除图片：用 delete_sheet_image
+   - 保存文件：用 save_workbook
+
+3. **遇到困难时要想办法解决**：发散思维，寻找可用的解决方案！
+   - 优先尝试用MCP工具
+   - MCP没有的功能 → 尝试用Python脚本解决
+   - 不要直接说"做不了"
+
+4. **只有这两种情况才写VBA**：
+   - 用户明确说"帮我写一个VBA宏"
+   - 用户明确说"生成VBA代码"
+
+5. **绝对原则**：不能关闭或重新打开用户当前打开的Excel文件
+
+6. **清理临时文件**：用完Python脚本后，必须删除生成的临时文件（如 .py、.txt、.json 等），用户指定保存的除外！
+
+## MCP可用工具
+
+### 数据读写
+- get_excel_data: 获取Excel数据
+- set_excel_data: 设置Excel数据
+- read_cell: 读取单个单元格
+- write_cell: 写入单个单元格
+
+### 批量操作（更快！）
+- batch_write_cells: 批量写入多个单元格
+- batch_write_rows: 批量写入多行数据
+- batch_set_colors: 批量设置单元格颜色
+- batch_create_formulas: 批量创建公式
+
+### 行列操作
+- insert_rows: 插入行
+- delete_rows: 删除行
+- insert_columns: 插入列
+- delete_columns: 删除列
+
+### 行列调整
+- set_column_width: 设置列宽
+- set_row_height: 设置行高
+
+### 单元格操作
+- merge_cells: 合并单元格
+- unmerge_cells: 取消合并单元格
+
+### 格式设置
+- set_cell_color: 设置单元格背景颜色
+- set_cell_font_color: 设置单元格字体颜色
+- set_cell_bold: 设置单元格字体粗体
+
+### 公式和计算
+- create_formula: 创建公式
+
+### 工作表管理
+- add_new_sheet: 添加新工作表
+- delete_sheet: 删除工作表
+- get_workbook_info: 获取工作簿信息
+
+### 图片处理（重要！）
+- extract_images_from_sheet: 提取图片到文件（优先）
+- extract_images_from_excel: 从Excel内部提取图片（更稳定）
+- list_sheet_images: 列出图片信息
+- delete_sheet_image: 删除图片
+
+### VBA相关
+- write_vba_code: 写入VBA代码
+- read_vba_code: 读取VBA代码
+- execute_vba_macro: 运行VBA宏
+
+### 文件操作
+- save_workbook: 保存工作簿
+
+## 常见任务示例
+
+### 批量写入数据
+用户：把10行数据写入Excel
+```
+用 batch_write_rows(sheet_name="Sheet1", start_row=2, data=[[...], [...], ...])
+```
+
+### 批量标红
+用户：把年龄小于18的单元格标红
+```
+用 batch_set_colors(sheet_name="Sheet1", cells=[{"cell": "B2", "color": "red"}, ...])
+```
+
+### 插入行
+用户：在第3行插入2行
+```
+用 insert_rows(sheet_name="Sheet1", row=3, count=2)
+```
+
+### 合并单元格
+用户：把A1到D1合并
+```
+用 merge_cells(sheet_name="Sheet1", range_address="A1:D1")
+```
+
+### 识别图片中的表格（重要经验！）
+用户：帮我识别这张图片里的表格
+```
+**步骤：**
+1. 调用 extract_images_from_sheet() 提取图片
+2. 如果失败 → 用 extract_images_from_excel() 从Excel内部提取（更稳定）
+3. 发散思维，寻找可用的识别方案（如检查Python环境的OCR库，推荐EasyOCR）
+4. 用找到的方案识别图片内容
+5. 用 batch_write_rows 批量写入Excel
+6. 用 batch_set_colors 设置表格格式
+7. 用 save_workbook 保存
+8. 删除所有临时文件（.py、.txt、图片等）
+```
+
+### 删除图片
+用户：删除工作表中的某张图片
+```
+用 delete_sheet_image(sheet_name="Sheet1", image_index=1)
+```
+
+## 注意事项
+
+1. **优先用批量工具！** 更快更高效
+2. **图片提取优先用 extract_images_from_sheet**，失败时用 extract_images_from_excel
+3. **用完临时文件后必须删除！** 不要留在用户文件夹里
+4. 遇到问题先想办法解决，不要直接说"做不了"
+5. Excel打开时无法用Python写入，但MCP可以实时操作