The Game Crafter

The Game Crafter MCP サーバー

AI アシスタントをThe Game Crafter API に接続する MCP サーバーです。自然な会話を通じて、卓上ゲームのデザイン、管理、価格設定ができます。

コンポーネントカタログの閲覧、ゲームプロジェクトの作成、カードデッキやボードの追加、アートワークのアップロード、価格の即時見積もりなど、すべて AI アシスタントを通じて行えます。

対象ユーザー

TGC のウェブインターフェースを手動で操作する代わりに、AI アシスタントを通じてプロジェクトを管理したい、インディーのボードゲームデザイナー、卓上ゲームのクリエイター、TGC ユーザー。

前提条件

• Node.js 18 以降
• TGC アカウント — こちらから登録
• TGC API キー — こちらから生成

インストール

オプション 1：リモート（Apify でホスト）— インストール不要

次のホストサーバーに接続します：

https://chillbot3000--tgc-mcp-server.apify.actor/mcp

ローカルでのセットアップは不要です。authenticate ツールを呼び出す際に、TGC の認証情報を指定してください。利用料金は Apify のイベントごとの従量課金モデルに基づき、操作ごとに請求されます（一般的なセッションで約 $0.09）。

Glama Connectors でも利用できます。

オプション 2：ローカル（npx 経由）

Claude Desktop の設定にサーバーを追加します（macOS の場合は ~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "thegamecrafter": {
      "command": "npx",
      "args": ["-y", "@alex-gon/tgc-mcp-server"],
      "env": {
        "TGC_API_KEY_ID": "your-api-key-id",
        "TGC_USERNAME": "your-tgc-username",
        "TGC_PASSWORD": "your-tgc-password"
      }
    }
  }
}

Claude Desktop を再起動します。サーバーは自動的にダウンロードされ、MCP 接続に表示されます。

git clone https://github.com/alex-gon/thegamecrafter-mcp-server.git
cd thegamecrafter-mcp-server
npm install && npm run build

設定

テンプレートについては .env.example を参照してください。

利用可能なツール

ツール

リソース

プロンプト

プロンプトの例

AI アシスタントに次のように話しかけてみてください。

• 「The Game Crafter にある自分のすべてのゲームと、それぞれのコンポーネント一覧を表示して」
• 「標準的なポーカーデッキとタックボックスを使った、Stellar Drift という新しいカードゲームを作成して」
• 「ポーカーカードの表面画像には、どのピクセル寸法が必要ですか？」
• 「この画像をアップロードして、カードデッキの表面画像に設定して」
• 「現在のコンポーネントに基づいて、ゲームの費用を見積もって」
• 「ゼロから新しいゲームプロジェクトを設定するのを手伝って。手順を案内して」
• 「ボードゲームで利用できるコンポーネントの種類は何ですか？」
• 「テスト用のゲームプロジェクトを削除して」

制限事項

• レート制限 — サーバーは TGC へのリクエストを毎秒 3 件（TGC の上限である毎秒 4 件を下回る値）に制限し、セッションごとの上限を読み取り 500 件、書き込み 200 件に設定しています。
• 認証 — 認証情報は authenticate ツールのパラメーター（リモートでの使用時に必須）として渡すか、環境変数（ローカルの stdio 用）で指定できます。OAuth 2.1 への対応は今後のリリースで予定されています。
• ファイルのアップロード — 1 ファイルあたりの最大サイズは 50 MB です。画像のサイズは 50x50 ピクセル以上、10,000x10,000 ピクセル以下である必要があります。対応形式：PNG、JPG、GIF、BMP、TIFF、SVG、WebP、PDF。
• トランスポート — ローカルでの使用には stdio を使用します。リモート HTTP はホストされた Apify エンドポイントから利用できます。
• 読み取り専用カタログ — コンポーネントカタログと価格情報は TGC から提供され、変更できません。

コントリビューション

バグ報告やプルリクエストを歓迎します。変更したい内容について話し合うため、まず issue を作成してください。

開発サーバーを起動するには：

cp .env.example .env    # fill in your credentials
npm run dev             # starts with tsx + hot reload
npm test                # run the test suite

ライセンス

MIT