mcpField
G
gamenumerics

gamenumerics

ローカル
github.com/26048608982lp-ai開発ツール16 週間前に更新
リポジトリ

gamenumerics について

gamenumericsは、ゲームデザイナーや小規模チーム向けの決定論的な数値エンジンです。バランス設計、表計算ベースの設計、ライブ運営の監査に使え、stdio MCPサーバーから17個の読み取り専用ツールで表の解析やシミュレーションを行えます。

主な機能

  1. 01XLSXテーブルのインポートと正規化
  2. 02バトルとガチャ結果のシミュレーション
  3. 03成長曲線とゲーム数式の分析
  4. 04列パターンとテーブル関係の推定
  5. 05ワークスペースの評価と分析
  6. 06読み取り専用MCPツール群

活用シーン

  1. 01成長や進行バランスの監査
  2. 02バトルやガチャ結果のシミュレーション
  3. 03表計算データから数式を推定

MCP 対応

stdio MCPサーバーは、表のインポートと参照、数値分析とシミュレーション、ワークスペース操作など、17個の読み取り専用ツールをMCPクライアントに公開します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "26048608982lp-ai-gamenumerics": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-gamenumerics"
      ],
      "env": {
        "GND_WORKSPACES_DIR": "<GND_WORKSPACES_DIR>"
      }
    }
  }
}
起動コマンドnpx -y mcp-server-gamenumerics
設定が必要な環境変数
GND_WORKSPACES_DIRWorkspace root directory where imported xlsx tables land (default: ~/.gamenumerics/workspaces)

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npmmcp-server-gamenumerics0.1.2

ツール

17

掲載時のツール一覧 · 2 週間前に更新

パラメーター型必須説明
modulestringいいえモジュールで絞り込みます（任意）：settings/growth/equipment/level/hero/economy/rogue/talent/enemy/gamedata

詳細

gamenumerics

ゲームデザイン向けの決定論的な数値エンジン — MCP 経由で AI コーディングエージェントに公開します。 xlsx 設定テーブルをインポートし、成長曲線を監査し、バトル／ガチャのシミュレーションを実行して、ゲームのスプレッドシートに隠れた数式をリバースエンジニアリングします。数値の回答はすべて、依存関係ゼロの純粋関数エンジンから得られます — LLM による推測はありません。

対象ユーザー：ローグライク／デッキ構築ゲームのバランス調整、スプレッドシート主体の数値設計、ライブ運営の調整監査に取り組むゲームデザイナーや個人／少人数チームです — エンジンとの統合は不要で、設定テーブルを xlsx にエクスポートするだけで使えます。

クイックスタート（MCP サーバー）

これらのエンジンを最も手早く使う方法は、mcp-server-gamenumerics を利用することです。Claude Code、Cursor、ZCode、または任意の MCP ホストに 17 個の読み取り専用ツールを公開する stdio MCP サーバーです。

npx -y mcp-server-gamenumerics

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

ホストごとの完全な設定（Claude Code／Cursor／ZCode）、17 個のツールのリファレンス、パフォーマンスのベースラインは、mcp-server/README.md に記載されています。

内容

パス内容
lib/engine/formula-engine/19 個の純粋関数数値エンジン：バトルシミュレーション、ガチャ確率＋モンテカルロ法、EHP×EDPS パワーモデル、成長予測、経済の生産／消費、進行曲線、レベルシステム、難易度のミラーリング
lib/table/xlsx／スプレッドシートの正規化：2 行ヘッダーの統合、列パターンの検出（算術／幾何）、基礎値×係数の関係推定、Theil-Sen によるロバストな曲線フィッティング
lib/agent/tools/エンジンをラップするツール定義（JSON Schema＋ハンドラー） — 読み取り／監査用インターフェース
mcp-server/npm で配布される stdio MCP サーバー（mcp-server-gamenumerics、esbuild による単一ファイルバンドル）
scripts/lib/workspace-import.tsxlsx → 正規化済み JSON ワークスペースのインポートパイプライン

ツール一覧（17 個 = マッピング済み 14 個＋メタ 3 個）

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

設計上、読み取り専用です — 書き込みツールは、ウェブワークベンチの人間による確認フローの背後にあります（別製品であり、このリポジトリには含まれません）。

開発

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

ライセンス

MIT

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。