English Français العربية

io.github.26048608982lp-ai/gamenumerics

السجل الرسمي الألعاب والرياضة والترفيه

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

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package mcp-server-gamenumerics
Claude Code 
claude mcp add gamenumerics -e 'GND_WORKSPACES_DIR=<GND_WORKSPACES_DIR>' -- npx -y mcp-server-gamenumerics@0.1.2
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "gamenumerics": {
            "command": "npx",
            "args": [
                "-y",
                "mcp-server-gamenumerics@0.1.2"
            ],
            "env": {
                "GND_WORKSPACES_DIR": "<GND_WORKSPACES_DIR>"
            }
        }
    }
}

متغيرات البيئة

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

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. gamenumerics
  2. Quick start (MCP server)
  3. What's inside
  4. Tool surface (17 = 14 mapped + 3 meta)
  5. Development
  6. License

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:

npx -y mcp-server-gamenumerics
{ "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

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

License

MIT

الأسئلة الشائعة

ما هو io.github.26048608982lp-ai/gamenumerics؟

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

كيف أثبّت io.github.26048608982lp-ai/gamenumerics؟

يعمل على جهازك. في Claude Code: claude mcp add gamenumerics -e 'GND_WORKSPACES_DIR=<GND_WORKSPACES_DIR>' -- npx -y mcp-server-gamenumerics@0.1.2. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.26048608982lp-ai/gamenumerics إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل io.github.26048608982lp-ai/gamenumerics مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.26048608982lp-ai/gamenumerics؟

ينشره 26048608982lp-ai. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.