pixfaro

Pixfaro MCP — 适用于所有图像模型的图像生成 MCP 服务

一次 MCP 连接，一个预付余额，覆盖所有主流图像模型——目前支持 Nano Banana、Gemini，接下来支持 GPT Image（在 list_models 中显示为“即将推出”）。 Pixfaro 负责管理提供商账号、密钥、重试和格式差异；你的 Agent 只需请求生成图像。

兼容 Claude Desktop、Claude Code、Cursor、Windsurf 以及任何 MCP 客户端。

快速开始 — 无需终端（约 1 分钟）

远程服务是最简单的方式：粘贴一个 URL，在打开的浏览器窗口中登录 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）；Cursor 会自行运行 OAuth 流程。

ChatGPT（Pro/Plus/Business/Edu）：Settings → 启用 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. 让你的 Agent 生成图像。就是这么简单。

对于 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 共用一个 HTTP 客户端。余额和提供商层由 api.pixfaro.com 提供支持——这段代码刻意保持精简，方便你在交出密钥前阅读。

MIT © Pixfaro