pixfaro

Pixfaro MCP — あらゆる画像モデルに対応する画像生成 MCP サーバー

1 つの MCP 接続、1 つのプリペイド残高で、主要な画像モデルすべてに対応します — 現在は Nano Banana、Gemini、次に GPT Image（list_models では「coming soon」と表示）。 プロバイダーアカウント、キー、再試行、形式の違いは Pixfaro が処理するため、エージェントは画像を依頼するだけです。

Claude Desktop、Claude Code、Cursor、Windsurf、およびあらゆる MCP クライアントで利用できます。

クイックスタート — ターミナル不要（約1分）

リモートサーバーを使うのが最も簡単です。URL を 1 つ貼り付け、開いたブラウザーウィンドウで Pixfaro アカウントにサインインします。ファイルに API キーを記載する必要はありません。

Claude（claude.ai / Claude Desktop、すべてのプラン）: Settings → Connectors → Add custom connector → URL https://mcp.pixfaro.com/mcp → サインイン。 （Team/Enterprise の場合：組織の Owner が Organization settings → Connectors → Custom → Web から一度追加します。）

Cursor: Cursor に追加 → — または Cursor Settings → MCP → Add new MCP server（種類は URL、アドレスは https://mcp.pixfaro.com/mcp）。OAuth フローは Cursor が実行します。

ChatGPT（Pro/Plus/Business/Edu）: Settings → enable Developer mode （2026年7月の名称変更以降、コネクターは Plugins にあります。以前は Connectors → Advanced でした）→ URL https://mcp.pixfaro.com/mcp を指定してカスタムコネクターを追加し、OAuth を設定します。

クイックスタート — コマンドライン／設定ファイル

1. pixfaro.com で API キーを取得し、残高をチャージします（サブスクリプション不要）。
2. MCP クライアントの設定にサーバーを追加します。

{
  "mcpServers": {
    "pixfaro": {
      "command": "npx",
      "args": ["-y", "@pixfaro/mcp"],
      "env": { "PIXFARO_KEY": "pf_live_…" }
    }
  }
}

3. エージェントに画像を依頼します。これで完了です。

Claude Code の場合：

claude mcp add pixfaro -e PIXFARO_KEY=pf_live_… -- npx -y @pixfaro/mcp

ストリーミング可能な HTTP に対応したクライアントでは、同じファイルでリモート形式も利用できます — キーは不要で、初回利用時に OAuth を行います。

{ "mcpServers": { "pixfaro": { "url": "https://mcp.pixfaro.com/mcp" } } }
``` Clients
without OAuth can pass an API key instead: `Authorization: Bearer pf_live_…`.

## Tools

| Tool | What it does |
|---|---|
| `generate_image` | prompt → hosted image URL (+cost and balance in the reply) |
| `edit_image` | natural-language edit of a previous generation by its `img_…` id |
| `list_models` | models with price, latency, and what each is best for |
| `render_template` | typeset card (quote/post) from a template — $0.02, ~2 s, sharp type · *remote server; npx parity coming in 0.2* |
| `list_templates` | card templates with slots, style axes and exact prices · *remote server* |
| `upload_asset` | upload a PNG/JPEG (≤5 MB) as a reusable asset (e.g. a card avatar) · *remote server* |
| `get_balance` | current prepaid balance |

Replies carry a hosted URL, never base64 — your agent's context stays small.

Both generation tools accept `aspect_ratio` (e.g. `"16:9"`, `"9:16"`). Edits
keep the source image's shape when you omit it — pass one only to reshape.

## CLI

The same package family ships an unscoped CLI for scripts, CI, and pipelines:

```bash
export PIXFARO_KEY=pf_live_…
npx pixfaro gen "a lighthouse at night, minimal flat style" -a 16:9 -o cover.png
npx pixfaro models
npx pixfaro balance
npx pixfaro edit img_8f2a… "make the sky darker" -o v2.png

環境変数

変数	意味
PIXFARO_KEY	API キー（pf_live_…）— models を除くすべての機能で必須です
PIXFARO_API_URL	エンドポイントの上書き設定（デフォルトは https://api.pixfaro.com）

このリポジトリについて

Pixfaro API を利用するシンプルなオープンクライアントです。MCP サーバー（@pixfaro/mcp）と pixfaro CLI は、1 つの HTTP クライアントを共有します。残高／プロバイダーレイヤーは api.pixfaro.com の背後にあります — このコードは、キーを渡す前に読めるよう、意図的に小規模にしています。

MIT © Pixfaro