Gamenumerics

io.github.26048608982lp-aiPublished by GitHub account 26048608982lp-aiv0.1.2Updated Oct 24, 2026

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

VerifiedSTDIODesktop onlyDeveloper ToolsData & Analytics

Overview

AI-generated overview

A local MCP server that gives an AI assistant 17 read-only tools for game numerical design: importing xlsx config tables, auditing curves, and running battle or

What you can do
Import xlsx config tables into a local workspace and list or read the resulting tables and workspaces, including switching the active workspace and reading stored memory notes.
Requirements
Runs locally over stdio, typically launched with npx from the npm package mcp-server-gamenumerics, so Node.js is needed. Workspace root is set by the GND_WORKSPACES_DIR environment variable (default ~/.gamenumerics/workspaces). No authentication is declared.
Before you install
The server is read-only by design; write tools are said to live in a separate web product, so expect no edits to your tables from here. Imported xlsx files are copied into a local workspace directory, so point GND_WORKSPACES_DIR at a location you are comfortable storing game config data in. Numeric results come from the bundled engines and should be checked against your own design intent.

Installation

In SourceWeft

  1. Open Gamenumerics in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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

Source: README.md at commit bc7c44b

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.2LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts