Gamenumerics

io.github.26048608982lp-ai由 GitHub 账号 26048608982lp-ai 发布v0.1.2更新于 Oct 24, 2026

Game numerical design & balance auditing MCP server — 17 deterministic tools, zero LLM guessing.

已验证STDIO仅桌面开发者工具数据与分析

概览

AI 生成的概览

本地 MCP 服务器，为 AI 助手提供 17 个只读工具，用于游戏数值设计：导入 xlsx 配置表、审计曲线、运行战斗与抽卡模拟。

可以做什么
将 xlsx 配置表导入本地工作区，并列出或读取生成的表与工作区，可切换当前工作区并读取已存的记忆笔记。
运行要求
通过 stdio 在本地运行，通常用 npx 启动 npm 包 mcp-server-gamenumerics，需要 Node.js。工作区根目录由环境变量 GND_WORKSPACES_DIR 指定（默认 ~/.gamenumerics/workspaces）。未声明任何身份验证。
安装前请注意
该服务器按设计为只读，写入类工具据称位于另一个独立的网页产品中，因此不要指望在此修改表格。导入的 xlsx 会被复制到本地工作区目录，请将 GND_WORKSPACES_DIR 指向你愿意存放游戏配置数据的位置。数值结果来自内置引擎，仍应结合自身设计意图核对。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Gamenumerics，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

gamenumerics

Deterministic numeric engines for game design — exposed to your AI coding agent via MCP. Import xlsx config tables, audit growth curves, run battle/gacha simulations, and reverse-engineer the formulas behind game spreadsheets. Every numeric answer comes from zero-dependency pure-function engines — zero LLM guessing.

Who it's for: game designers and solo/small teams doing roguelike / deckbuilder balance work, spreadsheet-driven numerical design, or live-ops tuning audits — no engine integration required, just an xlsx export of your config tables.

Quick start (MCP server)

The fastest way to use these engines is through mcp-server-gamenumerics — a stdio MCP server exposing 17 read-only tools to Claude Code, Cursor, ZCode, or any MCP host:

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

Full per-host config (Claude Code / Cursor / ZCode), the 17-tool reference, and the performance baseline live in mcp-server/README.md.

What's inside

PathWhat it is
lib/engine/formula-engine/19 pure-function numeric engines: battle simulation, gacha probability + Monte Carlo, EHP×EDPS power model, growth projection, economy production/consumption, progression curves, level systems, difficulty mirroring
lib/table/xlsx/spreadsheet normalization: dual-row header merge, column pattern detection (arithmetic/geometric), base×coefficient relation inference, Theil-Sen robust curve fitting
lib/agent/tools/Tool definitions (JSON Schema + handlers) wrapping the engines — the read/audit surface
mcp-server/The npm-distributed stdio MCP server (mcp-server-gamenumerics, esbuild single-file bundle)
scripts/lib/workspace-import.tsxlsx → normalized JSON workspace import pipeline

Tool surface (17 = 14 mapped + 3 meta)

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

Read-only by design — write tools stay behind the web workbench's human-in-the-loop confirm flow (separate product, not part of this repo).

Development

bash
npm installnpm test         # vitest: engine + table + mcp-server suitesnpm 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

License

MIT

来源：README.md，提交 bc7c44b

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.1.2最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分