プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。Google でログインするとレビューを書けます。プロトタイプ · 30分ごとに更新
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説 ログイン

PixelForge

作者:freemaバージョン 0.3.0i★ 6iパソコンで動くリポジトリ ↗
レジストリ名io.github.freema/pixelforge-mcp

インストール方法

できること

Forge pixel art sprites, animations, tilesets and game assets with Google Gemini.

作者による原文

  • 接続方法 パソコンで動く
  • アカウントまたはキー GEMINI_API_KEY が必要
  • カテゴリ ゲーム・スポーツ・料理・学習

この順位の理由

一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり

人気10/80GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます
新しさ12/1230 日以内のリリースかコード更新で満点
応答中0/8前回の確認でクラウドのエンドポイントが応答
利用スコア22/100

品質: 基本チェック 3/3 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)

インストール

使っているAIアプリを選んで、設定をコピーしてください。

ひとことで AI にインストールしてもらう

PixelForge をインストールして。https://mcp.popnx.com/i/freema-pixelforge-mcp.md に従い、コマンドを見せて、私が OK するまで実行しないで。

パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る

チェック 3/3 合格 · あなたのパソコンで動きます · ✓ コマンド確認済み 2026年11月13日

まず:どの AI を使っていますか?

使っているアプリを選ぶと、下に手順が表示されます。

Claude につなげますが、先に準備が必要です

PixelForge のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Node.js を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません

AI にインストールしてもらう

このメッセージを Claude のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Claude に MCP server PixelForge を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "pixelforge": { "command": "npx", "args": [ "-y", "pixelforge-mcp" ], "env": { "GEMINI_API_KEY": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) GEMINI_API_KEY は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、PixelForge のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. PixelForge に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    キーの取り方は下の提供元 README にあります

  3. パソコン版 Claude アプリの設定ファイルを開く

    SettingsDeveloperEdit Config

  4. この設定を貼り付けて保存

    {
      "mcpServers": {
        "pixelforge": {
          "command": "npx",
          "args": [
            "-y",
            "pixelforge-mcp"
          ],
          "env": {
            "GEMINI_API_KEY": "your-value"
          }
        }
      }
    }

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  5. Claude を終了してもう一度開く

  6. 試してみる

    PixelForge を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude が PixelForge を使っていると言うか、回答に PixelForge のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

ChatGPT はまだ PixelForge につなげません

PixelForge はパソコンに入れて使うものですが、ChatGPT は Web 上で動くサーバーにしかつなげません

代わりにできること

A · PixelForge につなげるアプリを使う

  • PixelForge のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Node.js を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
  • PixelForge のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Node.js を入れてください(1 回だけ)
  • PixelForge のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Node.js を入れてください(1 回だけ)
  • PixelForge のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Node.js を入れてください(1 回だけ)

B · ゲーム・スポーツ・料理・学習 の中で ChatGPT につなげる別のサーバー

同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました

Claude Code につなげますが、先に準備が必要です

PixelForge のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Node.js を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを Claude Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Claude Code に MCP server PixelForge を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):claude mcp add --scope user pixelforge --env GEMINI_API_KEY=your-value -- npx -y pixelforge-mcp 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) GEMINI_API_KEY は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、PixelForge のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. PixelForge に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    キーの取り方は下の提供元 README にあります

  3. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く

  4. このコマンドを貼り付けて Enter

    claude mcp add --scope user pixelforge --env GEMINI_API_KEY=your-value -- npx -y pixelforge-mcp

    Enter の前に「your-value」を自分のキーに書き換えてください

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  5. Claude Code で /mcp と入力

    PixelForge が一覧にあり、接続済みと表示されれば OK です

  6. 試してみる

    PixelForge を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude Code が PixelForge を使っていると言うか、回答に PixelForge のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Cursor につなげますが、先に準備が必要です

PixelForge のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Node.js を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを Cursor のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Cursor に MCP server PixelForge を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "pixelforge": { "command": "npx", "args": [ "-y", "pixelforge-mcp" ], "env": { "GEMINI_API_KEY": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) GEMINI_API_KEY は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、PixelForge のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. PixelForge に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    キーの取り方は下の提供元 README にあります

  3. このボタンで Cursor を開く

    Cursor で開く

    Cursor がインストールの確認をするので Install を押します

  4. キーを入力

    PixelForge の設定で GEMINI_API_KEY が空です。自分のキーを入れて保存します

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  5. Cursor の AI チャットを Agent モードで開く

  6. 試してみる

    PixelForge を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Cursor が PixelForge を使っていると言うか、回答に PixelForge のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

VS Code につなげますが、先に準備が必要です

PixelForge のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Node.js を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを VS Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの VS Code に MCP server PixelForge を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "servers": { "pixelforge": { "type": "stdio", "command": "npx", "args": [ "-y", "pixelforge-mcp" ], "env": { "GEMINI_API_KEY": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) GEMINI_API_KEY は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、PixelForge のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. PixelForge に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    キーの取り方は下の提供元 README にあります

  3. このボタンで VS Code を開く

    VS Code で開く

    VS Code がインストールの確認をするので Install を押します

  4. キーを入力

    PixelForge の設定で GEMINI_API_KEY が空です。自分のキーを入れて保存します

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  5. VS Code の AI チャットを Agent モードで開く

  6. 試してみる

    PixelForge を使って、私に何ができるか教えて、1 つやってみせて

    ✓ VS Code が PixelForge を使っていると言うか、回答に PixelForge のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください

MCP を使えるアプリをすべて見る →

JSON 設定は下の「開発者向け」にあります

つまずいたら?PixelForge を使っている人に聞いてみましょう💬 ディスカッション →
開発者向け:ターミナルのコマンドと JSON 設定

パソコンにインストール

Claude Code

claude mcp add --scope user pixelforge --env GEMINI_API_KEY=your-value -- npx -y pixelforge-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "pixelforge": {
      "command": "npx",
      "args": [
        "-y",
        "pixelforge-mcp"
      ],
      "env": {
        "GEMINI_API_KEY": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "pixelforge": {
      "command": "npx",
      "args": [
        "-y",
        "pixelforge-mcp"
      ],
      "env": {
        "GEMINI_API_KEY": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "pixelforge": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "pixelforge-mcp"
      ],
      "env": {
        "GEMINI_API_KEY": "your-value"
      }
    }
  }
}

自分で入力する値

  • GEMINI_API_KEY 秘密 必須 env
    Google Gemini API key (https://aistudio.google.com/apikey)

説明は英語の原文のままです。

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

ひと目でわかる

週あたりのダウンロードi
261/週
接続方法
パソコンで動く
最新バージョンi
0.3.0
レジストリ公開日i
2026年11月6日
コードの最終更新i
2026年11月6日
作者
freema
パッケージ
npm: pixelforge-mcp
レジストリでの状態
有効

使えるアプリ

このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。

パソコン上で動かせるアプリ

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

すべてのアプリと長所・短所 →

できること

パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月20日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名は、リポジトリを所有するGitHubアカウント freema で確認済みです

  • ✓ 合格

    今もメンテナンスされている

    コードの最終更新:14 日前

  • ✓ 合格

    ライセンスがある

    MITを使用

  • – 対象外

    エンドポイントが応答する

    これはパソコンで動くため、インターネット上のエンドポイントはありません

  • – 対象外

    OAuthでサインイン

    パソコンで動き、代わりにローカルの設定を使います

  • … 未チェック

    ツールの説明に隠れた指示がない

    パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

公開済みの脆弱性(OSV.dev)

OSV.dev に pixelforge-mcp@0.3.0 の登録はありません

このバージョンのパッケージ本体のみ確認。すべての依存関係ではありません · 確認日 2026年11月15日

確認していること → · JSON

作者の方へ:再確認の依頼・情報の誤りの報告
作者向け:README にバッジを付ける

作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/freema-pixelforge-mcp.svg)](https://mcp.popnx.com/en/servers/freema-pixelforge-mcp)

話し合い

質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。

まだ投稿はありません。最初の質問や共有をどうぞ。

ここの投稿は利用者によるもので、PopNx チームのものではありません。

ログインして投稿

ユーザーレビュー

まだレビューはありません

ログインしてレビューを書く

ゲーム・スポーツ・料理・学習のほかのサーバーとの比較i

  • このカテゴリのほかの1631件のうち95%よりスターが多い
  • このカテゴリのほかの1631件のうち67%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの1631件のうち99%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

PixelForgeは安全ですか?

当てはまる基本チェック3項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか?

入力が必要なもの:GEMINI_API_KEY

パソコンで動きますか、それともクラウドですか?

あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。

今もメンテナンスされていますか?

GitHubリポジトリの最終更新は14 日前、最新バージョン(0.3.0)がレジストリに届いたのは14 日前です。

どのアプリで使えますか?

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにNode.jsも必要です。

代わりに使えるものは?

同じカテゴリには:LearnHouse, Anime Garden, WilmAI, Lumify Sports Intelligence, Savecraft

似た働きのほかの候補

同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。

カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

LearnHouse

Build, edit and run courses, learning paths and communities in your LearnHouse academy.

作者:learnhouse広く使われている★ 2482昨日更新

クラウドで動く✓ 提供元 · learnhouse.app

WilmAI

Finland's Wilma school system for parents and students: schedule, homework, exams and messages.

作者:aikarjal成長中↓ 1399/週★ 89 リポジトリ全体のスター11 日前更新

パソコンで動く✓ 提供元 · wilm.ai

Savecraft

Savecraft serves real save game data and expert game knowledge to AI assistants.

作者:joshsymonds初期★ 137 か月前更新

クラウドで動くリポジトリはアーカイブ済み✓ 提供元 · savecraft.gg
似たものと比べる
これ
PixelForge
LearnHouseAnime GardenWilmAILumify Sports IntelligenceSavecraft
動く場所パソコンにインストールが必要クラウドで動き、インストール不要クラウドで動き、インストール不要パソコンにインストールが必要クラウドで動き、インストール不要クラウドで動き、インストール不要
キーが必要はいいいえいいえいいえはいいいえ
Claude で + から追加いいえいいえいいえいいえいいえいいえ
基本チェック3/35/54/43/34/43/4
ライセンスMITAGPL-3.0AGPL-3.0MITMITApache-2.0
料金登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

pixelforge-mcp

MCP server that forges pixel art sprites & game assets using Google Gemini — generate, crop, split & process, all from your AI assistant.

Features

  • AI-powered generation — sprites, animations, backgrounds, thumbnails, tilesets and item kits via Google Gemini
  • Smart post-processing — background removal, auto-crop, pixelation downscale, square padding
  • Chroma key transparency — background: "chromakey" generates on pure green and keys it out in HSV space for clean edges
  • Sprite sheet splitting — auto-detect and split sheets into individual frames
  • Style presets — neon, retro, gameboy, snes, clean
  • Pure PNG pipeline — zero-dependency PNG encoder/decoder, no native modules
  • Reference matching — pass existing sprites to match visual style

Installation

Claude Code (CLI)
claude mcp add pixelforge npx pixelforge-mcp@latest \

--env GEMINI_API_KEY=your-api-key

Claude Code (Plugin)
/plugin marketplace add freema/pixelforge-mcp

/plugin install pixelforge-mcp

Restart Claude Code to load the MCP server (check with /mcp).

Claude Desktop

Add to your claude_desktop_config.json:

{

"mcpServers": { "pixelforge": { "command": "npx", "args": ["-y", "pixelforge-mcp@latest"], "env": { "GEMINI_API_KEY": "your-api-key" } } } }

Manual (any MCP client)

Add to your .mcp.json or equivalent config:

{

"mcpServers": { "pixelforge": { "command": "npx", "args": ["-y", "pixelforge-mcp@latest"], "env": { "GEMINI_API_KEY": "your-api-key" } } } }

Requirements

Tools

forge_sprite

Generate a single pixel art sprite with automatic post-processing (crop, bg removal, downscale, square padding).

"Generate a green slime enemy sprite, 48px, retro style"

Required: description, outputPath Optional: size (default: 48), style, background (default: black, see Backgrounds & transparency), aspect, square, model, references

forge_animation

Generate animation frames as individual, ready-to-use frame PNGs.

By default each frame is generated in its own request, with the first frame passed as a reference image to the following ones (reference chain) — this keeps proportions, colors and outline consistent across frames. Set useReferenceChain: false to generate a single sprite sheet and auto-split it instead. useTemplate: true does the same and additionally guides the sheet with a numbered grid template.

"Animate a slime bouncing, 4 frames"

Required: description, action, outputPrefix Optional: frames (default: 3), frameDescriptions, names, size, style, background (default: black, see Backgrounds & transparency), square, useReferenceChain (default: true), useTemplate (default: false), model, references

forge_background

Generate a full game background — no cropping, outputs the image as-is.

"Deep space background with stars and nebula, 16:9"

Required: description, outputPath, aspect Optional: style, model

forge_thumbnail

Generate a game thumbnail/screenshot. Pass references for visual consistency with your sprites.

"Space shooter scene with player ship vs alien rows"

Required: description, outputPath Optional: references, aspect (default: 4:3), style, model

forge_tileset

Generate a seamless, tileable square texture for terrain, floors and walls. No background removal — the texture fills the whole canvas.

"Seamless grass terrain tile, 32px, snes style"

Required: description, outputPath Optional: size (default: 32), style, model

forge_item_kit

Generate up to 16 related sprites in one batch. Items are drawn together on a grid for visual consistency, then split into individual PNGs.

"Fruit icons: red apple, banana, cherry, grapes"

Required: items, outputPrefix Optional: names, size (default: 48), style, background, square, model, references

process_sprite

Post-process an existing PNG — background removal, auto-crop, sprite sheet splitting.

"Split this sprite sheet into individual frames"

Required: inputPath Optional: outputPath, split, names, threshold, square, padding, skipCrop, skipTransparent

optimize_sprite

Downscale oversized AI images to true pixel art resolution using area-averaging (not blurry bilinear).

"Optimize this 1024px image down to 48px pixel art"

Required: inputPath, size Optional: outputPath, removeBackground, square

Backgrounds & transparency

Sprites are generated on a flat background color that is removed afterwards. The background parameter picks that color:

ValueBackgroundRemoval
chromakeyPure green #00FF00HSV chroma key — recommended for forge_sprite and forge_animation
black (default), whitePure black / whiteSoft alpha matting against the background color
forest, sky, dungeon, lava, ocean, sand, snow, nightScene-tinted solid colorSoft alpha matting against the background color
autoPicked from keywords in the description (falls back to black)Soft alpha matting against the background color

Chroma key (background: "chromakey") asks the model for a pure green screen and a bold dark outline around the sprite, then removes every pixel whose hue is within ±22° of green (with saturation and value above 0.3). Pixels just outside that range get a soft alpha ramp, so edges stay clean. Unlike the black or white backgrounds, it cannot eat dark or light pixels that belong to the sprite itself.

"Generate a knight sprite, 64px, background chromakey"

Avoid chromakey for sprites that are themselves bright green (slimes, leaves, emeralds) — those pixels would be keyed out as well. Use black, white or a scene color for them.

chromakey is never chosen by auto; it has to be requested explicitly. The HSV keyer runs in forge_sprite and forge_animation; forge_item_kit accepts the same background values but always uses the regular matting.

Models

AliasModel IDNotes
nano-banana, banananano-banana-pro-previewDefault — best for pixel art
flash, gemini-flashgemini-3.1-flash-image-previewFast, reliable
pro, gemini-progemini-3-pro-image-previewBest quality
25, gemini-25gemini-2.5-flash-imageStable fallback

Prompts

pixel_art_guide

Built-in MCP prompt with comprehensive pixel art generation guidelines — prompting rules, style tips, size recommendations, and best practices.

License

MIT — see LICENSE


Built by Tomas Grasl