{"_id":"mcp-server-gamenumerics","_rev":"8-0c5c51a4f3aa12e95fb3522cfa3e86f4","name":"mcp-server-gamenumerics","dist-tags":{"latest":"0.1.9"},"versions":{"0.1.0":{"name":"mcp-server-gamenumerics","version":"0.1.0","keywords":["mcp","model-context-protocol","game-design","game-numerics","roguelike","balance","spreadsheet","xlsx"],"license":"MIT","_id":"mcp-server-gamenumerics@0.1.0","maintainers":[{"name":"bombombombombom","email":"26048608982lp@gmail.com"}],"homepage":"https://github.com/26048608982lp-ai/aigamedesign#readme","bugs":{"url":"https://github.com/26048608982lp-ai/aigamedesign/issues"},"bin":{"gnd-mcp":"dist/index.js"},"dist":{"shasum":"fe8c0b4ce5fcf7a821e786c9c23f0779cedbdbf0","tarball":"https://registry.npmjs.org/mcp-server-gamenumerics/-/mcp-server-gamenumerics-0.1.0.tgz","fileCount":3,"integrity":"sha512-7MYApigvRdACeF+JZCLxxK2gBEtntj2xfcgLWPWffJT0SbnmvK6QxRj7yxSZcztsmsH68dylQ1qHEWAjumllEQ==","signatures":[{"sig":"MEYCIQC6zs4IhbhC0r4uhG6NsFS7KOzEUPNGWbPV44jM/BQ0RwIhANYT/tDujHUDH+gga2BHRyndvBJHDzkFgjSrW8CiocWl","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":18080},"type":"module","scripts":{"build":"node -e \"require('esbuild').buildSync({entryPoints:['src/index.ts'],bundle:true,platform:'node',format:'esm',outfile:'dist/index.js',banner:{js:`#!/usr/bin/env node\\nimport { createRequire } from 'module'; const require = createRequire(import.meta.url);`}})\"","check":"tsc --noEmit","prepublishOnly":"npm run build"},"_npmUser":{"name":"bombombombombom","email":"26048608982lp@gmail.com"},"deprecated":"0.1.0 缺失 dist 产物（发布事故），请升级 0.1.1","repository":{"url":"git+https://github.com/26048608982lp-ai/aigamedesign.git","type":"git","directory":"mcp-server"},"_npmVersion":"11.11.0","description":"游戏数值设计 MCP server——17 个确定性数值工具（查表/算力/审计/导入）接入任意 MCP 宿主（Claude Code / Cursor / ZCode 等）","directories":{},"_nodeVersion":"24.14.1","dependencies":{"xlsx":"https://cdn.sheetjs.com/xlsx-0.20.3/xlsx-0.20.3.tgz","@modelcontextprotocol/server":"^2.0.0"},"_hasShrinkwrap":false,"devDependencies":{"esbuild":"^0.28.2"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server-gamenumerics_0.1.0_1789173684491_0.22059527651660238","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"mcp-server-gamenumerics","version":"0.1.1","keywords":["mcp","model-context-protocol","game-design","game-numerics","roguelike","balance","spreadsheet","xlsx"],"license":"MIT","_id":"mcp-server-gamenumerics@0.1.1","maintainers":[{"name":"bombombombombom","email":"26048608982lp@gmail.com"}],"homepage":"https://github.com/26048608982lp-ai/aigamedesign#readme","bugs":{"url":"https://github.com/26048608982lp-ai/aigamedesign/issues"},"bin":{"gnd-mcp":"dist/index.js"},"dist":{"shasum":"c5843e5012a51b0b33a5ac90431d3650bffa38c5","tarball":"https://registry.npmjs.org/mcp-server-gamenumerics/-/mcp-server-gamenumerics-0.1.1.tgz","fileCount":4,"integrity":"sha512-DZ1uV4mwpbJqlEZK2/7KUqp0tfh57ydKKr+JeVMr4UyHiNGM5EVhOTYFHYOwGpfy5n7+Y6SzEW805N++avKghQ==","signatures":[{"sig":"MEQCIALtnneuvx6Ji8RBI4qAtEvOjl5tXqKMoAbTafuWtVKgAiAiY83E6Dc/44l4nDyVNRGtjL8krFqEyzQK0at+4QG2tQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":4103609},"type":"module","scripts":{"build":"node -e \"require('esbuild').buildSync({entryPoints:['src/index.ts'],bundle:true,platform:'node',format:'esm',outfile:'dist/index.js',banner:{js:`#!/usr/bin/env node\\nimport { createRequire } from 'module'; const require = createRequire(import.meta.url);`}})\"","check":"tsc --noEmit","prepublishOnly":"npm run build"},"_npmUser":{"name":"bombombombombom","email":"26048608982lp@gmail.com"},"repository":{"url":"git+https://github.com/26048608982lp-ai/aigamedesign.git","type":"git","directory":"mcp-server"},"_npmVersion":"11.11.0","description":"游戏数值设计 MCP server——17 个确定性数值工具（查表/算力/审计/导入）接入任意 MCP 宿主（Claude Code / Cursor / ZCode 等）","directories":{},"_nodeVersion":"24.14.1","dependencies":{"xlsx":"https://cdn.sheetjs.com/xlsx-0.20.3/xlsx-0.20.3.tgz","@modelcontextprotocol/server":"^2.0.0"},"_hasShrinkwrap":false,"devDependencies":{"esbuild":"^0.28.2"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server-gamenumerics_0.1.1_1789173738962_0.27406443305773","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"mcp-server-gamenumerics","version":"0.1.2","keywords":["mcp","model-context-protocol","mcp-server","claude","claude-code","cursor","game-design","game-balance","game-balancing","game-numerics","game-economy","gamedev","roguelike","deckbuilder","balance","spreadsheet","xlsx","数值策划","数值","游戏数值"],"license":"MIT","_id":"mcp-server-gamenumerics@0.1.2","maintainers":[{"name":"bombombombombom","email":"26048608982lp@gmail.com"}],"homepage":"https://github.com/26048608982lp-ai/gamenumerics#readme","bugs":{"url":"https://github.com/26048608982lp-ai/gamenumerics/issues"},"bin":{"gnd-mcp":"dist/index.js"},"dist":{"shasum":"4d400b68a384cd5957604e10c9b926714fe24463","tarball":"https://registry.npmjs.org/mcp-server-gamenumerics/-/mcp-server-gamenumerics-0.1.2.tgz","fileCount":4,"integrity":"sha512-LvwM/DIPGt6hgVhZn1bTIy9EAwYAz1myiU7oq3q0KRIkPxoSAk/PjfKOw1i4Pr7aeGcZ8585LJfUp92iFkGjAA==","signatures":[{"sig":"MEQCICMIDLxNDWNTQb1tYEa5IdlJ/wy7agZydvMBfAarPgZkAiBWeEYTuYRDK8eUCfc1rxDirhAzqxnPrdvtfuU5f/F7uA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1708178},"type":"module","gitHead":"5202b74ddfe932f4bff70fd2d723af653d559fd0","mcpName":"io.github.26048608982lp-ai/gamenumerics","scripts":{"build":"node -e \"require('esbuild').buildSync({entryPoints:['src/index.ts'],bundle:true,platform:'node',format:'esm',outfile:'dist/index.js',banner:{js:`#!/usr/bin/env node\\nimport { createRequire } from 'module'; const require = createRequire(import.meta.url);`}})\"","check":"tsc --noEmit","prepublishOnly":"npm run build"},"_npmUser":{"name":"bombombombombom","email":"26048608982lp@gmail.com"},"repository":{"url":"git+https://github.com/26048608982lp-ai/gamenumerics.git","type":"git","directory":"mcp-server"},"_npmVersion":"11.11.0","description":"MCP server for game numerical design & balance auditing — 17 deterministic tools (xlsx table import, growth-curve audit, battle/gacha simulation, power curve) for Claude Code, Cursor, ZCode & any MCP host. 游戏数值设计 MCP server：确定性数值引擎接入任意 MCP 宿主。","directories":{},"_nodeVersion":"24.14.1","dependencies":{"xlsx":"https://cdn.sheetjs.com/xlsx-0.20.3/xlsx-0.20.3.tgz","@modelcontextprotocol/server":"^2.0.0"},"_hasShrinkwrap":false,"devDependencies":{"esbuild":"^0.28.2"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server-gamenumerics_0.1.2_1789290020913_0.7484235316338388","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"mcp-server-gamenumerics","version":"0.1.3","keywords":["mcp","model-context-protocol","mcp-server","claude","claude-code","cursor","game-design","game-balance","game-balancing","game-numerics","game-economy","gamedev","roguelike","deckbuilder","balance","spreadsheet","xlsx","数值策划","数值","游戏数值"],"license":"MIT","_id":"mcp-server-gamenumerics@0.1.3","maintainers":[{"name":"bombombombombom","email":"26048608982lp@gmail.com"}],"homepage":"https://github.com/26048608982lp-ai/aigamedesign#readme","bugs":{"url":"https://github.com/26048608982lp-ai/aigamedesign/issues"},"bin":{"gnd-mcp":"dist/index.js"},"dist":{"shasum":"fad684707a74f343c12c084883dd2c56241f0bfd","tarball":"https://registry.npmjs.org/mcp-server-gamenumerics/-/mcp-server-gamenumerics-0.1.3.tgz","fileCount":4,"integrity":"sha512-v4cLTrREy6WKeaY1/ZlPyu3SQdFE1ROB0SRU6nvQgxNxROqmWlQtabZsEuueWAX9VOam0NkWrpcrVuw9HTe+/Q==","signatures":[{"sig":"MEQCIE0h+1OZUidukTSRQ8h4p5xKfKNzhTZerxLJkHMC6fmAAiB0UEsEkkAMcGg7smZe10OS34jzWTmJo8zYb6ovIcyGHw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1828016},"type":"module","gitHead":"aa58152cab8b323f3e12bf1e74f6808f12ae087a","scripts":{"build":"node -e \"require('esbuild').buildSync({entryPoints:['src/index.ts'],bundle:true,platform:'node',format:'esm',outfile:'dist/index.js',banner:{js:`#!/usr/bin/env node\\nimport { createRequire } from 'module'; const require = createRequire(import.meta.url);`}})\"","check":"tsc --noEmit","prepublishOnly":"npm run build"},"_npmUser":{"name":"bombombombombom","email":"26048608982lp@gmail.com"},"repository":{"url":"git+https://github.com/26048608982lp-ai/aigamedesign.git","type":"git","directory":"mcp-server"},"_npmVersion":"11.11.0","description":"MCP server for game numerical design & balance auditing — 17 deterministic tools (xlsx table import, growth-curve audit, battle/gacha simulation, power curve) for Claude Code, Cursor, ZCode & any MCP host. 游戏数值设计 MCP server：确定性数值引擎接入任意 MCP 宿主。","directories":{},"_nodeVersion":"24.14.1","dependencies":{"xlsx":"https://cdn.sheetjs.com/xlsx-0.20.3/xlsx-0.20.3.tgz","@modelcontextprotocol/server":"^2.0.0"},"_hasShrinkwrap":false,"devDependencies":{"esbuild":"^0.28.2"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server-gamenumerics_0.1.3_1789312148353_0.43179243612254714","host":"s3://npm-registry-packages-npm-production"}},"0.1.4":{"name":"mcp-server-gamenumerics","version":"0.1.4","keywords":["mcp","model-context-protocol","mcp-server","claude","claude-code","cursor","game-design","game-balance","game-balancing","game-numerics","game-economy","gamedev","roguelike","deckbuilder","balance","spreadsheet","xlsx","数值策划","数值","游戏数值"],"license":"MIT","_id":"mcp-server-gamenumerics@0.1.4","maintainers":[{"name":"bombombombombom","email":"26048608982lp@gmail.com"}],"homepage":"https://github.com/26048608982lp-ai/gamenumerics/tree/main/mcp-server#readme","bugs":{"url":"https://github.com/26048608982lp-ai/gamenumerics/issues"},"bin":{"gnd-mcp":"dist/index.js"},"dist":{"shasum":"eccf49ecbf2294487ec5a32dfba43ee92b5a8466","tarball":"https://registry.npmjs.org/mcp-server-gamenumerics/-/mcp-server-gamenumerics-0.1.4.tgz","fileCount":4,"integrity":"sha512-r9mIE1yjVjjSSOvt3LPmZG9/fdeUtPwnaddWDeSwfGqjF2MlZWCKJ1l/IBX8yFzbmWCcQ7jGO8MFvW6vCXylnA==","signatures":[{"sig":"MEUCIBu03NMkYEgF/78VRkbhVLT23e3IwlmlDVt6vSJmvxMLAiEA1IoFGY11dxOx/JdaStF/bWujgKSkbuBi7auAmuaNggA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1828197},"type":"module","gitHead":"eee197835b0b69e6ec0239cb5ede24568d9e306a","scripts":{"build":"node -e \"require('esbuild').buildSync({entryPoints:['src/index.ts'],bundle:true,platform:'node',format:'esm',outfile:'dist/index.js',banner:{js:`#!/usr/bin/env node\\nimport { createRequire } from 'module'; const require = createRequire(import.meta.url);`}})\"","check":"tsc --noEmit","prepublishOnly":"npm run build"},"_npmUser":{"name":"bombombombombom","email":"26048608982lp@gmail.com"},"repository":{"url":"git+https://github.com/26048608982lp-ai/gamenumerics.git","type":"git","directory":"mcp-server"},"_npmVersion":"11.11.0","description":"MCP server for game numerical design & balance auditing — 20 deterministic tools (xlsx table import, growth-curve audit, battle/gacha simulation, power curve) for Claude Code, Cursor, ZCode & any MCP host. 游戏数值设计 MCP server：确定性数值引擎接入任意 MCP 宿主。","directories":{},"_nodeVersion":"24.14.1","dependencies":{"xlsx":"https://cdn.sheetjs.com/xlsx-0.20.3/xlsx-0.20.3.tgz","@modelcontextprotocol/server":"^2.0.0"},"_hasShrinkwrap":false,"devDependencies":{"esbuild":"^0.28.2"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server-gamenumerics_0.1.4_1789386049232_0.39919605341941566","host":"s3://npm-registry-packages-npm-production"}},"0.1.5":{"name":"mcp-server-gamenumerics","version":"0.1.5","keywords":["mcp","model-context-protocol","mcp-server","claude","claude-code","cursor","game-design","game-balance","game-balancing","game-numerics","game-economy","gamedev","roguelike","deckbuilder","balance","spreadsheet","xlsx","数值策划","数值","游戏数值"],"license":"MIT","_id":"mcp-server-gamenumerics@0.1.5","maintainers":[{"name":"bombombombombom","email":"26048608982lp@gmail.com"}],"homepage":"https://github.com/26048608982lp-ai/gamenumerics/tree/main/mcp-server#readme","bugs":{"url":"https://github.com/26048608982lp-ai/gamenumerics/issues"},"bin":{"gnd-mcp":"dist/index.js"},"dist":{"shasum":"0f4c36e7380b8a1c4f56cbc420a79e045db2d4a5","tarball":"https://registry.npmjs.org/mcp-server-gamenumerics/-/mcp-server-gamenumerics-0.1.5.tgz","fileCount":4,"integrity":"sha512-c7q6MSeBL1V+guXjKLU+O+Ej9sEYiGLMnpRh4/AiJtvi/SZsGiS31Z31+xzLgUbxoqWrd99yzPvWUATyMbXeXg==","signatures":[{"sig":"MEUCIQCWPnxGRE1BI3B+NUsolMfR25rw7S2CErrLOD8jo+ZwPAIgTuKIEzyOOnkn9ZWhiw5hC9GxST4nj4fRuLOXkt3M+aw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEYCIQCG/Kt1kKPZ3TBxwfLzCkhBe/vE+33FaQQ2PKI3yM9xsQIhANgQ6kXt9PQnMhrYwB7zZYcoTX5+S8D015fBydEvocSx","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1828709},"type":"module","gitHead":"174495639d70f8018937d72a3e5b1b9a2c7ff496","scripts":{"build":"node -e \"require('esbuild').buildSync({entryPoints:['src/index.ts'],bundle:true,platform:'node',format:'esm',outfile:'dist/index.js',banner:{js:`#!/usr/bin/env node\\nimport { createRequire } from 'module'; const require = createRequire(import.meta.url);`}})\"","check":"tsc --noEmit","prepublishOnly":"npm run build"},"_npmUser":{"name":"bombombombombom","email":"26048608982lp@gmail.com"},"repository":{"url":"git+https://github.com/26048608982lp-ai/gamenumerics.git","type":"git","directory":"mcp-server"},"_npmVersion":"11.11.0","description":"MCP server for game numerical design & balance auditing — 20 deterministic tools (xlsx table import, growth-curve audit, battle/gacha simulation, power curve) for Claude Code, Cursor, ZCode & any MCP host. 游戏数值设计 MCP server：确定性数值引擎接入任意 MCP 宿主。","directories":{},"_nodeVersion":"24.14.1","dependencies":{"xlsx":"https://cdn.sheetjs.com/xlsx-0.20.3/xlsx-0.20.3.tgz","@modelcontextprotocol/server":"^2.0.0"},"_hasShrinkwrap":false,"devDependencies":{"esbuild":"^0.28.2"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server-gamenumerics_0.1.5_1789460734805_0.7502573447037084","host":"s3://npm-registry-packages-npm-production"}},"0.1.9":{"_id":"mcp-server-gamenumerics@0.1.9","bin":{"gnd-mcp":"dist/index.js"},"bugs":{"url":"https://github.com/26048608982lp-ai/gamenumerics/issues"},"dist":{"shasum":"e2ee197b6b72d637bc985d7fbb2cfbf3c8e1aa38","tarball":"https://registry.npmjs.org/mcp-server-gamenumerics/-/mcp-server-gamenumerics-0.1.9.tgz","fileCount":4,"integrity":"sha512-KaOaaxGBl/FzKtD4Lo7GAPSF07j0aWDiZEH//llyA31CRiNkOokgSqt7VuzWhGiyG8BDYWeyrzhR2ZHoVIHQNg==","signatures":[{"sig":"MEUCIApZxsDnEcq+astWULdoE5qlxq+2cvqryT8O56aIVGu1AiEAv3fz8MJoJd9asbaBL4A7kSk+ItLaW/K5gvx4xUeYj04=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIE7TE3JhTjBgxnRphpY8BzV1BOPcGva0BfXgPxI7ZsMJAiA7K31Chv+uKReq1px3zlHXQ7I298FGxdJWJGyAr6Viow=="}],"unpackedSize":3139761},"name":"mcp-server-gamenumerics","type":"module","gitHead":"aa550609d5c96c6ad87144b5d8d2c57753725ac8","license":"MIT","scripts":{"build":"node -e \"require('esbuild').buildSync({entryPoints:['src/index.ts'],bundle:true,platform:'node',format:'esm',outfile:'dist/index.js',banner:{js:`#!/usr/bin/env node\\nimport { createRequire } from 'module'; const require = createRequire(import.meta.url);`}})\"","check":"tsc --noEmit","prepublishOnly":"npm run build"},"version":"0.1.9","_npmUser":{"name":"bombombombombom","email":"26048608982lp@gmail.com"},"homepage":"https://github.com/26048608982lp-ai/gamenumerics/tree/main/mcp-server#readme","keywords":["mcp","model-context-protocol","mcp-server","claude","claude-code","cursor","game-design","game-balance","game-balancing","game-numerics","game-economy","gamedev","roguelike","deckbuilder","balance","spreadsheet","xlsx","数值策划","数值","游戏数值"],"repository":{"url":"git+https://github.com/26048608982lp-ai/gamenumerics.git","type":"git","directory":"mcp-server"},"_npmVersion":"11.19.1","description":"MCP server for game numerical design & balance auditing — 25 deterministic tools (xlsx table import, growth-curve audit, battle/gacha simulation, power curve, gacha pool audit, genre template, numeric contract baseline) for Claude Code, Cursor, ZCode & an","directories":{},"maintainers":[{"name":"bombombombombom","email":"26048608982lp@gmail.com"}],"_nodeVersion":"24.22.2","dependencies":{"xlsx":"https://cdn.sheetjs.com/xlsx-0.20.3/xlsx-0.20.3.tgz","@modelcontextprotocol/server":"^2.0.0"},"_hasShrinkwrap":false,"devDependencies":{"esbuild":"^0.28.2"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-server-gamenumerics_0.1.9_1793623475935_0.682491342304994"}}},"time":{"created":"2026-09-12T00:41:24.447Z","modified":"2026-11-02T12:44:36.215Z","0.1.0":"2026-09-12T00:41:24.618Z","0.1.1":"2026-09-12T00:42:19.125Z","0.1.2":"2026-09-13T09:00:21.073Z","0.1.3":"2026-09-13T15:09:08.499Z","0.1.4":"2026-09-14T11:40:49.378Z","0.1.5":"2026-09-15T08:25:34.921Z","0.1.9":"2026-11-02T12:44:36.060Z"},"bugs":{"url":"https://github.com/26048608982lp-ai/gamenumerics/issues"},"license":"MIT","homepage":"https://github.com/26048608982lp-ai/gamenumerics/tree/main/mcp-server#readme","keywords":["mcp","model-context-protocol","mcp-server","claude","claude-code","cursor","game-design","game-balance","game-balancing","game-numerics","game-economy","gamedev","roguelike","deckbuilder","balance","spreadsheet","xlsx","数值策划","数值","游戏数值"],"repository":{"url":"git+https://github.com/26048608982lp-ai/gamenumerics.git","type":"git","directory":"mcp-server"},"description":"MCP server for game numerical design & balance auditing — 25 deterministic tools (xlsx table import, growth-curve audit, battle/gacha simulation, power curve, gacha pool audit, genre template, numeric contract baseline) for Claude Code, Cursor, ZCode & an","maintainers":[{"name":"bombombombombom","email":"26048608982lp@gmail.com"}],"readme":"# mcp-server-gamenumerics\r\n\r\n> **MCP server for game numerical design & balance auditing.** 25 deterministic tools that let your AI coding agent (Claude Code, Cursor, ZCode, or any MCP host) import xlsx config tables, audit growth curves, run battle/gacha simulations, and reverse-engineer the formulas behind game spreadsheets — every numeric answer comes from deterministic pure-function engines, zero LLM guessing.\r\n\r\n**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.\r\n\r\n**What you get — 25 tools**: `import_xlsx` (dual-row header merge + column-pattern detection) · `list_tables` / `read_table` (workspace read, filter & paginate) · `battle_simulate` / `simulate_gacha` (Monte Carlo) / `compute_power` (EHP×EDPS) / `power_curve` / `eval_formula` / `audit_column` (expected-vs-actual reconciliation) / `infer_column_rule` (Theil-Sen robust fitting) / `infer_table_relation` (base×coefficient structures) · `simulate_battle` (multi-unit turn-based state machine) / `audit_balance` (by-level / by-stage / build-matrix / by-skill batch audits) / `audit_gacha_pool` (gacha pool config audit: validation + published rates + acquisition distribution + exact-vs-MC reconciliation) / `get_genre_template` (genre four-module starting plan: battle+progression+gacha+level preset direct-compute with key numeric anchors) · `grade_workspace` / `profile_table` / `infer_foreign_keys` (structure analysis) · `list_workspaces` / `set_workspace` / `read_memory` (session meta) · `export_table` (lua/json export, W3) · `recon_diff` (L3 cross-table reconciliation, W4) · `suggest_refs` (referential-integrity candidate discovery, W5) · `export_baseline` (numeric contract baseline: engine outputs as engine-agnostic JSON with A-class assertable / B-class reference layering + FNV-1a input fingerprint; includes `formula_sheet` — executable formula contract with per-formula expression / human-readable form / variable fallback chains / degenerate branches / engine-computed sample anchors). Read-only surface — write tools stay behind the web workbench's human-in-the-loop confirm flow.\r\n\r\n**Quick start** (Node.js 18+):\r\n\r\n```bash\r\nnpx -y mcp-server-gamenumerics\r\n```\r\n\r\n```json\r\n{ \"mcpServers\": { \"gamenumerics\": { \"command\": \"npx\", \"args\": [\"-y\", \"mcp-server-gamenumerics\"] } } }\r\n```\r\n\r\n**Performance**: ~150ms cold start (spawn → initialize → tools/list) · ~79MB idle memory · 25 tools · clean exit on stdin close.\r\n\r\n**Verified hosts**: ZCode ✓ · Claude Code ✓ — per-host config snippets below; host-verification log in [HOST-VERIFICATION.md](HOST-VERIFICATION.md).\r\n\r\n---\r\n\r\n以下为中文详细文档。\r\n\r\n游戏数值设计 Agent 工作站的 MCP（Model Context Protocol）形态——**read/算/审计面**的 stdio server。\r\n\r\n把本项目 agent harness 的 20+ 个零依赖纯函数数值引擎，以 **18 个只读数值工具 + 7 个会话 meta 工具**（共 25 个）带给任意 MCP 宿主（Claude Code / Cursor / ZCode 等）：在开发者自己的 AI 编辑器里直接说「检查这份 HeroGrowth.xlsx 的数值曲线」，宿主 LLM 即可完成导入 → 查表 → 曲线审计的完整链路。\r\n\r\n核心叙事一句话：**LLM 负责理解、编排、解释；确定性引擎负责数值正确性**——所有数值结论都出自确定性纯函数，不依赖 LLM 心算。\r\n\r\n## 安装与启动\r\n\r\n前置：Node.js 18+。\r\n\r\n**方式一：npx 免安装直跑（推荐，宿主配置推荐写法）**\r\n\r\n```bash\r\nnpx -y mcp-server-gamenumerics\r\n```\r\n\r\n**方式二：全局安装**\r\n\r\n```bash\r\nnpm install -g mcp-server-gamenumerics\r\ngnd-mcp # 本包配置了 bin: gnd-mcp，全局安装后直接以该命令启动\r\n```\r\n\r\n**方式三：从源码运行（开发者路径）**\r\n\r\n```bash\r\n# 在 mcp-server/ 目录内\r\nnpm install        # 安装 @modelcontextprotocol/server\r\nnpm run build      # esbuild bundle 出单文件 dist/index.js\r\nnode dist/index.js # 即 stdio server（stdin/stdout 通信，直接运行会等待输入，属正常）\r\n```\r\n\r\n`npx .`（在 mcp-server/ 目录内）与 `node dist/index.js` 等价可用。\r\n\r\n## 环境变量\r\n\r\n| 变量 | 说明 | 缺省 |\r\n|------|------|------|\r\n| `GND_WORKSPACES_DIR` | 工作区根目录（**建议绝对路径**；相对值按用户主目录解析，不依赖进程 cwd）——import_xlsx 装配产物落于此，写侧严格限于该目录内 | `~/.gamenumerics/workspaces` |\r\n\r\nMCP 用户机器上无本仓库源码，工作区绝不落到仓库 `workspaces/` 目录。`import_xlsx` 只接受本地磁盘路径（UNC/网络路径 `//server/...` 前置拒绝——网络解析可能长时间阻塞进程）。\r\n\r\n## 宿主配置\r\n\r\n以下配置提供两种接入形态：`npx` 形式直接使用 npm 包（推荐，无需本仓库源码）；本地路径形式供源码开发者使用，其中的 `<仓库绝对路径>` 替换为本仓库实际路径（Windows 路径正反斜杠均可）。\r\n\r\n### Claude Code\r\n\r\nnpx 形式（推荐）：\r\n\r\n```bash\r\nclaude mcp add gamenumerics --env GND_WORKSPACES_DIR=D:/mcp-workspaces -- npx -y mcp-server-gamenumerics\r\n```\r\n\r\n本地路径形式（源码开发者用）：\r\n\r\n```bash\r\nclaude mcp add gamenumerics -- node <仓库绝对路径>/mcp-server/dist/index.js\r\n```\r\n\r\n可选指定工作区根（本地路径形式；npx 形式同样加 `--env` 即可）：\r\n\r\n```bash\r\nclaude mcp add gamenumerics --env GND_WORKSPACES_DIR=D:/mcp-workspaces -- node <仓库绝对路径>/mcp-server/dist/index.js\r\n```\r\n\r\n### Cursor\r\n\r\n项目级 `.cursor/mcp.json`（或用户级全局配置）。\r\n\r\nnpx 形式（推荐）：\r\n\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"gamenumerics\": {\r\n      \"command\": \"npx\",\r\n      \"args\": [\"-y\", \"mcp-server-gamenumerics\"],\r\n      \"env\": { \"GND_WORKSPACES_DIR\": \"D:/mcp-workspaces\" }\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n本地路径形式（源码开发者用）：\r\n\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"gamenumerics\": {\r\n      \"command\": \"node\",\r\n      \"args\": [\"<仓库绝对路径>/mcp-server/dist/index.js\"],\r\n      \"env\": { \"GND_WORKSPACES_DIR\": \"D:/mcp-workspaces\" }\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n### ZCode\r\n\r\n在 ZCode 的 MCP 配置（项目级 `.zcode/mcp.json` 或用户级配置文件，以所用版本文档为准）中加入同形态的 `mcpServers` 条目——`npx` 形式与本地 `node` 路径形式皆可。\r\n\r\nnpx 形式（推荐）：\r\n\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"gamenumerics\": {\r\n      \"command\": \"npx\",\r\n      \"args\": [\"-y\", \"mcp-server-gamenumerics\"],\r\n      \"env\": { \"GND_WORKSPACES_DIR\": \"D:/mcp-workspaces\" }\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n本地路径形式（源码开发者用）：\r\n\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"gamenumerics\": {\r\n      \"command\": \"node\",\r\n      \"args\": [\"<仓库绝对路径>/mcp-server/dist/index.js\"],\r\n      \"env\": { \"GND_WORKSPACES_DIR\": \"D:/mcp-workspaces\" }\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n配置后重启宿主，工具列表中出现 `import_xlsx` / `list_tables` 等 25 个工具即接入成功。\r\n\r\n## 性能基线\r\n\r\n| 指标 | 数值 |\r\n|------|------|\r\n| 冷启动（spawn → initialize → tools/list 全链） | ~150ms |\r\n| 空闲内存（握手完成后单进程） | ~79MB |\r\n| 工具面 | 25 个（18 映射 + 7 meta） |\r\n| stdin 关闭 | 干净退出，无残留进程 |\r\n\r\n测量条件：Windows 11 / Node v24 / 单进程空闲态——数字随环境浮动。复现命令（仓库根目录）：`npx tsx scripts/mcp-benchmark.ts`（3 轮独立子进程取中位）。\r\n\r\n内存大头是 Node.js 运行时基线（空进程 ~48MB），本包从 40 工具 registry 到 25 工具面的全链业务增量克制在 ~30MB——在「MCP server 动辄 100-200MB」是社区普遍抱怨的背景下，这是选型上的差异点。\r\n\r\n## 工具面清单（25 = 18 映射 + 7 meta）\r\n\r\n### 数值契约基线——如何在你的游戏项目 CI 里断言（export_baseline）\r\n\r\n基线文件（`gnd-baseline/1`）= 设计期引擎直算结果的引擎无关序列化，供 Cocos / Godot / Unity\r\n等任意引擎项目在自己的 CI 中验证「运行期实现 ≡ 设计期基线」。\r\n\r\n- **A 类 `class: \"assertable\"`（可复现断言）**：`damage`（伤害公式采样）/ `power_curve`（战力曲线，\r\n  工作区表装载）/ `growth_projection` / `difficulty_mirror`（battle confirmed 产物直传）/\r\n  `formula_sheet`（公式结构契约，见下节）——纯公式直算，同输入必然逐位复现。\r\n- **B 类 `class: \"reference\"`（参考基准）**：`battle_matrix`（胜率矩阵，强制显式 seed）——MC 统计\r\n  值依赖 LCG 随机序列，**不供断言**，仅作为设计期基准供偏差对比。\r\n\r\n断言方法（语言无关伪代码）：\r\n\r\n```\r\nbaseline = load(\"baseline-<kind>-<fingerprint8>.json\")\r\n# 1. 校验输入指纹：对你的输入 JSON 做 stable-stringify（递归键排序）后 FNV-1a 64（BigInt），\r\n#    与 baseline.meta.inputFingerprint 一致 → 输入未漂移\r\n#    排序规则（与 JS 实现对齐）：字符串键按 UTF-16 码元字典序；整数形键（如 \"1\",\"2\",\"10\"）\r\n#    按 JS 对象枚举序=数值升序——跨语言实现时须复刻此规则，否则整数形键输入指纹会误报漂移\r\n# 2. A 类断言：用你的运行期实现重放 baseline.input，逐值比较：\r\nfor each (expected, actual) in zip(baseline.output, yourImpl(baseline.input)):\r\n    assert abs(actual - expected) <= 1e-9 * max(1, abs(expected))   # meta.tolerance\r\n# 3. B 类：不做逐位断言；|your - reference| 显著偏离（如 > 5pp）时人工复核\r\n```\r\n\r\n注意事项：\r\n- `power_curve` 的 `power` 为**全精度未取整**值（工具层展示口径的 round 不进契约）；缺省参数\r\n  （formulaType=multiplicative / skillMultiplier=1 / critDmgMult=1.3 / stdAtk=当行 attack / stdSpeed=1）\r\n  见产物 `assumptions` 声明。\r\n- 工作区存在 `attribute-system.json` 时自动读入计价（v3 dual-channel 口径入契约并计入指纹）。\r\n- **大 JSON 链路诚实声明**：`growth_projection` / `difficulty_mirror` 的 battle confirmed 产物\r\n  达数十 KB，在 MCP 面需经宿主 LLM 转传——存在截断/数字失真风险（引擎侧 fail-closed 校验会\r\n  拦截坏数据，但可能体验不可用）。建议小输入试点或分段导出；参数与产物双向 1MB 上限。\r\n\r\n### formula_sheet——公式结构契约（伤害/战力公式的「是什么、怎么算、边界在哪」）\r\n\r\n基线数值回答「输入 X 得多少」，`formula_sheet`（`input` 不传、全量导出）回答**公式结构本身**——\r\n不在任何配置表里的信息：每条公式（伤害三分支 / 战力主路径，首批 11 条）含：\r\n\r\n- `expression`：可执行契约（`evalExpression/1` 方言：四则/幂/括号/变量 + 白名单函数\r\n  round/min/max/ceil/floor——⚠️ round 为半上取整向 +∞（JS Math.round，-2.5 → -2），非银行家舍入，\r\n  跨语言实现须按 `dialect.functions` 声明的语义复现）；\r\n- `humanReadable` + `variables`：人话数学形态 + 变量绑定（描述/单位/**兜底链**如\r\n  atkCoeff→attackCoefficient→缺省 1.0/来源指向基线 input 字段）；\r\n- `guards`：条件退化分支一等声明（如 speedFactor 在 speed≤0 时恒 1——方言无 if，\r\n  分段语义以 guards 为权威，`expression` 只表达主路径）；\r\n- `sourceRef`：源码锚（公式权威实现位置）；\r\n- `samples`：引擎直算样例锚，`kind:\"main\"`（可喂给 evalExpression 复算）与\r\n  `kind:\"degenerate\"`（退化输入，对照 guards 语义）分轨——重实现方跑全部样例即完成接入校验。\r\n\r\n消费方式：AI/程序读 `expression`/`samples` 精确复现；人读 `humanReadable`/`variables`/`guards`\r\n直观理解。`damage` 基线产物的 `output.formulas` 字段引用同 id 条目（数值↔结构交叉可溯）。\r\n引擎接入指南（Cocos Creator 3.x 直引 + 断言脚本）见仓库 `docs/integrations/cocos.md`。\r\n\r\n\r\n### 会话 meta 工具（7）\r\n\r\n| 工具 | 职责 |\r\n|------|------|\r\n| `import_xlsx` | 从本地 xlsx（绝对路径）导入并创建工作区：双行表头合并「父.子」列名、数值列自动识别等差/等比/常数模式，成功后设为当前工作区 |\r\n| `list_workspaces` | 列出工作区根下全部可用工作区 |\r\n| `set_workspace` | 按名切换当前工作区（后续全部数值工具作用于它） |\r\n| `export_table` | 导出当前工作区表为 lua record 数组模块或 JSON（columns 可收窄，超 1MB 拒绝） |\r\n| `recon_diff` | 跨表对账（L3）：两张表按声明键列对齐、值列逐格比对（誊抄/倍率誊抄/外键断链，容差=绝对半格+相对 1e-9） |\r\n| `suggest_refs` | 引用完整性候选发现（W5）：全表扫描「A 列疑似引用 B 表键列」的候选映射（值域包含+剪枝），确认后经 recon_diff 执行断链扫描 |\r\n| `export_baseline` | 数值契约基线导出：A 类可断言（damage/power_curve/growth_projection/difficulty_mirror/formula_sheet 公式结构契约）/ B 类参考（battle_matrix，强制 seed）；FNV-1a 输入指纹 + 确定性序列化 |\r\n\r\n### 工作区读取（2）\r\n\r\n| 工具 | 职责 |\r\n|------|------|\r\n| `list_tables` | 列出当前工作区全部数值表清单（表名/模块/行数/列名） |\r\n| `read_table` | 读取指定表的数据行（支持列选择/条件过滤/分页） |\r\n\r\n### 数值计算与审计（8）\r\n\r\n| 工具 | 职责 |\r\n|------|------|\r\n| `battle_simulate` | 战斗模拟（属性/伤害数值计算） |\r\n| `simulate_gacha` | 抽卡概率计算 + Monte Carlo 模拟 |\r\n| `compute_power` | 属性 → 战力（EHP×EDPS 解析式单源计算） |\r\n| `power_curve` | 批量战力曲线（多属性组对比） |\r\n| `eval_formula` | 求值数值公式表达式 |\r\n| `audit_column` | 列对账：实际值 vs 生成规则期望值的偏离点审计 |\r\n| `infer_column_rule` | 列规则逆向推断（Theil-Sen 稳健拟合等差/等比/幂律） |\r\n| `infer_table_relation` | 列间派生关系推断（还原「各列 = 基准 × 系数」生成结构） |\r\n\r\n### 战斗平衡（2，五体系 W4）\r\n\r\n| 工具 | 职责 |\r\n|------|------|\r\n| `simulate_battle` | 多单位回合制战斗模拟（确定性状态机）：阵容/技能循环/词条乘区的单局逐事件模拟或小批量 Monte Carlo 胜率 |\r\n| `audit_balance` | 批量平衡审计编排四模式：by-level 逐级胜率曲线+断崖检测 / by-stage 逐关扫表 / matrix 流派×胜率矩阵+dominance 点名 / by-skill 技能 DPR/EHR 排名 |\r\n\r\n### 卡池审计（1，gacha-pool T5）\r\n\r\n| 工具 | 职责 |\r\n|------|------|\r\n| `audit_gacha_pool` | 卡池配置审计（配置审计视角，与 simulate_gacha 的规划模拟分工）：配置 JSON 校验（概率守恒/曲线单调/禁出冲突，fail-closed 定位到项）+ 公示概率 + 目标英雄获取分布（平均/P50/P90/P99/最多）+ 成本期望 + 精确推演×MC 双口径 4.5σ 交叉核对 |\r\n\r\n### 品类模板（1，ui-sync T4）\r\n\r\n| 工具 | 职责 |\r\n|------|------|\r\n| `get_genre_template` | 品类四模块起点方案一键直算：品类问卷 19 键（overrides 逐键覆盖）→ assembleCardGameTemplate 组装 + battle/progression/gacha/level 四模块预设直算 + KB 级数值锚摘要（5v5 编队/星级碎片倍率/保底期望抽数/主线波次）+ assumptions |\r\n\r\n### 结构分析（3）\r\n\r\n| 工具 | 职责 |\r\n|------|------|\r\n| `grade_workspace` | 工作区数值质量评分 |\r\n| `profile_table` | 单表结构画像 |\r\n| `infer_foreign_keys` | 表间外键关系推断 |\r\n\r\n### 记忆（1）\r\n\r\n| 工具 | 职责 |\r\n|------|------|\r\n| `read_memory` | 读工作区记忆文件（PROFILE/facts，缺省回落公共 facts） |\r\n\r\n> 面边界说明：本 MCP 形态只暴露只读面——写表/规划/问卷/交付导出等依赖人在回路确认面板、登录身份或前端 UI 载荷的工具不在 stdio 面提供。\r\n\r\n## 使用示例\r\n\r\n对话示例（任意 MCP 宿主中）：\r\n\r\n> **用户**：检查这份 D:/data/HeroGrowth.xlsx 的数值曲线\r\n\r\n宿主 LLM 的典型编排（工具调用链）：\r\n\r\n1. `import_xlsx` `{ \"xlsxPath\": \"D:/data/HeroGrowth.xlsx\" }`\r\n   → 返回摘要：工作区 `HeroGrowth`、1 张表 `import/HeroGrowth`（3 行，双行表头探测 headerRows=2，`成长` 列为等比 1.1）\r\n2. `read_table` `{ \"table\": \"import/HeroGrowth\" }` → 读回行数据确认口径\r\n3. `infer_column_rule` 对 `成长` 列逆向拟合生成规则\r\n4. `audit_column` `{ \"table\": \"import/HeroGrowth\", \"column\": \"成长\", \"rule\": \"<上一步推断的表达式>\" }` → 对账偏离点（疑似手调值）\r\n\r\n若 headerRows 启发式探测失误（摘要回显可疑列名），在 `import_xlsx` 显式传 `\"sheets\": [{ \"sheet\": \"HeroGrowth\", \"headerRows\": 1 }]` 重试即可。\r\n\r\n## 开发\r\n\r\n```bash\r\n# 类型检查（mcp-server 自带独立 tsconfig，根 tsc exclude 本目录）\r\nnpm run check\r\n\r\n# 单测（经根仓库 vitest 收集：npm test，文件级 @vitest-environment node）\r\ncd .. && npx vitest run mcp-server/__tests__/\r\n\r\n# 真机冒烟（stdio 子进程拉起 dist/index.js 全链路，不进 CI；上一行 cd .. 后即处于仓库根目录）\r\nnpx tsx scripts/mcp-smoke.ts\r\n```\r\n\r\n架构一页纸见仓库 `docs/agent-harness-architecture.md`；本包 Spec 见 `docs/specs/v9-w2-mcp-server-spec.md`。\r\n","readmeFilename":"README.md"}