excel

Excel 配置表 Skill

游戏开发专用 Excel 配置表管理。SQL-over-Excel 引擎，26 个工具，支持高级 SQL 查询、批量操作、跨文件 JOIN。

快速调用

方式一：Skill 接入（首推）

安装（二选一）：

# 方式 A：OMP harness 用户（自动注册 skill）
# skill 文件部署到 ~/.omp/agent/skills/excel/，harness 自动发现

# 方式 B：手动安装
git clone https://github.com/TangentDomain/excel-mcp-server.git
cp -r excel-mcp-server/.omp/skills/excel ~/.omp/agent/skills/excel

使用：

# 首次运行自动安装依赖（uv venv + pip install 从 GitHub）
python ~/.omp/agent/skills/excel/bin/excel-cli.py query --file data.xlsx --sql "SELECT * FROM Sheet1"

# Windows venv 安装后可直接用 exe（跳过自举，更快）
~/.omp/agent/skills/excel/.venv/Scripts/excel-cli.exe <command> [options]

# 检查更新
excel-cli self-update --check
excel-cli self-update          # 更新到最新版

Skill 入口：~/.omp/agent/skills/excel/bin/excel-cli.py，首次运行自动创建 venv + 从 GitHub 安装，后续通过 self-update 更新。

方式二：源码直接调用（开发环境）

本项目即为 excel-mcp-server 源码，可以用 uv run 直接调用：

uv run python -m excel_mcp_server_fastmcp.cli <command> [options]

输出格式（所有命令统一）：JSON {success: bool, data: Any, message: str, meta: dict}

所有命令共用参数：--file <路径> 是每个命令的必填参数（除 self-update）。路径用绝对路径。

核心决策树：选对命令

读数据？
├─ 筛选/聚合/GROUP BY/JOIN/窗口函数/子查询 → query
├─ 知道精确坐标 A1:C10                     → get-range
├─ 不确定有哪些列                          → describe-table（列名+类型+样本）
├─ 只要表头                                → get-headers
├─ 搜某个值在哪张表                        → search / search-directory
└─ 追加数据前找空行                        → find-last-row

写数据？
├─ 按条件批量改（WHERE 筛选）              → update-query
├─ 精确坐标写入                            → update-range（默认覆盖！追加加 --insert-mode）
├─ 按 ID 改/插单行（幂等）                  → upsert-row（推荐单行操作）
├─ SQL INSERT 插入                         → insert-query
├─ 按条件删行                              → delete-query（必须 WHERE）
└─ 按行号删/插入行列                       → structure

其他？
├─ 工作表管理 → create-sheet / delete-sheet / rename-sheet / copy-sheet
├─ 格式化     → format-cells（字体/边框/合并/背景色）
├─ 行高列宽   → set-layout
├─ 公式       → set-formula
├─ 复杂逻辑   → run-python（可用 query/update/insert/delete 函数 + ExcelOperations）
├─ 两表对比   → compare-sheets
└─ 备份恢复   → backup