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 分