gamenumerics

Name: gamenumerics
Author: 26048608982lp-ai

本地服务

github.com/26048608982lp-ai开发工具16 周前更新

代码仓库

关于 gamenumerics

gamenumerics 为游戏设计师和小型团队提供确定性数值引擎，用于平衡性设计、表格驱动设计和运营调优审查。其 stdio MCP 服务提供 17 个只读工具，可导入表格、分析公式并运行模拟，避免由 LLM 猜测数值。

主要功能

01导入并规范化 XLSX 表格
02模拟战斗与抽卡结果
03分析成长曲线和游戏公式
04推断列模式与表格关系
05评估并分析工作区
06只读 MCP 工具集

适用场景

01审查成长与进度平衡
02模拟战斗或抽卡结果
03从表格推断数值公式

MCP 相关

stdio MCP 服务向 MCP 客户端提供 17 个只读工具，涵盖表格导入与查看、数值分析与模拟，以及工作区操作。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "26048608982lp-ai-gamenumerics": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-gamenumerics"
      ],
      "env": {
        "GND_WORKSPACES_DIR": "<GND_WORKSPACES_DIR>"
      }
    }
  }
}

启动命令npx -y mcp-server-gamenumerics

需要配置的环境变量

GND_WORKSPACES_DIRWorkspace root directory where imported xlsx tables land (default: ~/.gamenumerics/workspaces)

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmmcp-server-gamenumerics0.1.2stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
module	string	否	按模块过滤（可选）：settings/growth/equipment/level/hero/economy/rogue/talent/enemy/gamedata

详细介绍

gamenumerics

面向游戏设计的确定性数值引擎——通过 MCP 提供给你的编码 Agent 使用。 导入 xlsx 配置表、审计成长曲线、运行战斗／抽卡模拟，并逆向分析游戏电子表格背后的公式。所有数值结果均由零依赖的纯函数引擎计算得出，不靠大模型猜测。

适用对象：从事 roguelike／牌组构筑游戏平衡设计、基于电子表格的数值设计或线上运营调优审计的游戏设计师及个人／小型团队——无需集成游戏引擎，只需导出配置表的 xlsx 文件。

快速开始（MCP 服务）

使用这些引擎最快的方式是通过 mcp-server-gamenumerics——这是一个基于 stdio 的 MCP 服务，向 Claude Code、Cursor、ZCode 或任何 MCP 宿主提供 17 个只读工具：

npx -y mcp-server-gamenumerics

{ "mcpServers": { "gamenumerics": { "command": "npx", "args": ["-y", "mcp-server-gamenumerics"] } } }

各宿主的完整配置（Claude Code／Cursor／ZCode）、17 个工具的参考文档和性能基准见 mcp-server/README.md。

内容一览

路径	内容
`lib/engine/formula-engine/`	19 个纯函数数值引擎：战斗模拟、抽卡概率 + 蒙特卡洛模拟、EHP×EDPS 战力模型、成长预测、经济产出／消耗、进度曲线、等级系统、难度映射
`lib/table/`	xlsx／电子表格规范化：双行表头合并、列模式检测（等差／等比）、基础值×系数关系推断、Theil-Sen 鲁棒曲线拟合
`lib/agent/tools/`	封装引擎的工具定义（JSON Schema + 处理程序）——用于读取／审计
`mcp-server/`	通过 npm 分发的基于 stdio 的 MCP 服务（`mcp-server-gamenumerics`，使用 esbuild 打包为单文件）
`scripts/lib/workspace-import.ts`	xlsx → 规范化 JSON 工作区导入流水线

工具列表（17 个 = 14 个映射工具 + 3 个元工具）

import_xlsx · list_tables / read_table · battle_simulate / simulate_gacha / compute_power / power_curve / eval_formula / audit_column / infer_column_rule / infer_table_relation · grade_workspace / profile_table / infer_foreign_keys · list_workspaces / set_workspace / read_memory

按设计仅提供只读工具——写入工具仍通过网页工作台的人机确认流程提供（独立产品，不属于本仓库）。

开发

npm install
npm test         # vitest: engine + table + mcp-server suites
npm run check    # tsc --noEmit (lib + scripts)
npm run mcp:check  # tsc for mcp-server (own tsconfig)
npm run mcp:build  # esbuild bundle → mcp-server/dist/index.js