Pictify

@pictify/mcp-server

适用于 Pictify 的 MCP (Model Context Protocol) 服务，可通过 Claude、Cursor 和 Windsurf 等 AI Agent 生成图像、GIF、视频和 PDF。

一行安装，无需编写代码。 让 AI 助手通过自然语言创建 OG 图像、社交媒体卡片、截图、动画 GIF、PDF 发票、证书等内容。

它能做什么？

• 生成图像：根据 HTML/CSS、URL 或可复用模板生成（OG 图像、Twitter 卡片、横幅、产品截图）
• 渲染视频和动画 GIF：根据模板生成，包括由 Agent 编写的 Remotion 场景
• 渲染 PDF：根据模板生成发票、证书、报告、运输标签
• 批量生成：单次请求最多生成 100 张个性化图像（团队徽章、活动通行证、产品目录）
• 模板系统：提供 50 多种表达式函数，用于动态内容（条件判断、字符串操作、日期格式化）

兼容 Claude（claude.ai + Claude Code + Claude Desktop）、Cursor、Windsurf 及任何兼容 MCP 的客户端。

快速开始

Claude.ai（Web）

使用托管的远程服务，无需安装或 API 密钥：

1. 前往 claude.ai > Settings > Connectors
2. 点击 Add custom connector
3. URL：https://mcp.pictify.io
4. 点击 Add，然后点击 Connect — 登录 Pictify 并批准访问权限

无需在 Advanced Settings 中进行任何设置。连接会显示在 Pictify 设置中的 Connected apps 下，你可以随时断开连接。

本地服务的前提条件

npm 包使用 API 密钥进行身份验证，而非浏览器登录：

1. 在 pictify.io 注册或登录
2. 前往 API Tokens
3. 创建新令牌并复制

Claude Code

claude mcp add pictify -e PICTIFY_API_KEY=your_api_key -- npx -y @pictify/mcp-server

Claude Desktop

将以下内容添加到配置文件：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json
• Linux：~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "pictify": {
      "command": "npx",
      "args": ["-y", "@pictify/mcp-server"],
      "env": {
        "PICTIFY_API_KEY": "your_api_key"
      }
    }
  }
}

保存后重启 Claude Desktop。

Cursor

在 Cursor 的 MCP 设置中添加（Settings > MCP Servers）：

{
  "mcpServers": {
    "pictify": {
      "command": "npx",
      "args": ["-y", "@pictify/mcp-server"],
      "env": {
        "PICTIFY_API_KEY": "your_api_key"
      }
    }
  }
}

Windsurf

在 Windsurf 的 MCP 设置中添加：

{
  "mcpServers": {
    "pictify": {
      "command": "npx",
      "args": ["-y", "@pictify/mcp-server"],
      "env": {
        "PICTIFY_API_KEY": "your_api_key"
      }
    }
  }
}

示例

连接后，试试以下提示词：

创建社交媒体卡片：

“为我的博客文章创建一张 Twitter 卡片图像，标题为 ‘Getting Started with MCP’，背景为蓝色渐变，尺寸为 1200x630。”

截取网站：

“截取 stripe.com 的屏幕截图，尺寸为 1440x900。”

渲染模板：

“列出我的模板，并使用标题 ‘Hello World’ 渲染 blog-header 模板。”

批量生成图像：

“使用我的 team-badge 模板，为以下 10 位团队成员生成图像：……”

创建 PDF 发票：

“将我的发票模板渲染为 PDF，公司名称为 ‘Acme Inc’，金额为 ‘$1,500’，日期为 ‘March 2026’。”

可用工具

图像生成

工具	描述
pictify_create_image	根据 HTML/CSS、URL 截图或模板生成图像
pictify_get_image	按 ID 获取指定图像的详细信息

渲染历史记录

工具	描述
pictify_list_renders	在同一列表中查看所有渲染内容 — 图像、GIF、PDF 和视频

模板管理

工具	描述
pictify_list_templates	列出已保存的模板，支持筛选和分页
pictify_get_template	获取模板详情
pictify_get_template_variables	获取模板变量定义和类型
pictify_render_template	使用变量渲染模板——生成图片和 PDF（format: 'pdf'）
pictify_multi_size_render	在一次调用中以多种尺寸渲染同一模板
pictify_create_template	创建新模板（HTML 或 FabricJS）
pictify_update_template	更新现有模板
pictify_delete_template	删除模板
pictify_validate_expression	检查 {{ }} 表达式能否解析，再使用该表达式
pictify_list_expression_functions	列出表达式中可用的函数

批量操作

工具	描述
pictify_batch_render	启动批量渲染任务（最多 100 项，异步）
pictify_get_batch_results	查看批量任务状态并获取结果 URL
pictify_cancel_batch	取消正在运行的批量任务

视频

工具	描述
pictify_list_video_templates	列出你的 Remotion 视频模板
pictify_get_video_template	获取一个完整的视频模板
pictify_get_video_template_variables	查看视频模板所需的变量
pictify_render_video	将视频模板渲染为 MP4 或 GIF
pictify_create_video_template	上传你自己的 Remotion 场景作为模板
pictify_generate_video_template	根据文本提示词生成视频模板
pictify_update_video_template	更新视频模板的名称、尺寸、时长或代码
pictify_duplicate_video_template	复制视频模板
pictify_delete_video_template	删除视频模板

配置

变量	描述	默认值
PICTIFY_API_KEY	你的 Pictify API 密钥（stdio 模式必需）	—
PICTIFY_BASE_URL	自定义 API 基础 URL	https://api.pictify.io
PICTIFY_DEBUG	启用详细日志并输出到 stderr	false
PICTIFY_MCP_SOURCE	用于标识此 MCP 服务安装来源的标识符（例如 mcp.so、glama、smithery、claude_desktop_gallery、github）。每次 API 调用都会将其作为 X-Pictify-MCP-Source 发送，以便 Pictify 按目录统计安装来源。	unknown
PICTIFY_ANALYTICS_DISABLED	设置为 1、true 或 yes，即可完全停止发送使用情况分析数据	false

自托管 HTTP 服务时，还需设置 MCP_PORT、MCP_PUBLIC_URL（公共源地址，用于构建受保护资源元数据文档）和 PICTIFY_AUTH_SERVER_URL（客户端所连接的 OAuth 授权服务，默认为 https://api.pictify.io；也接受 PICTIFY_AUTH_SERVER）。

使用情况分析

此服务会将工具使用情况报告给 PostHog，以便我们了解 Agent 会调用哪些工具，以及哪些工具调用失败。每次调用都会记录工具名称、其参数和结果、耗时、是否出错、声明的意图、客户端名称和版本，以及——当 API 密钥能关联到帐户时——你的电子邮件地址和套餐。

参数和结果包括你传入的 HTML、URL、提示词和模板变量。如果你不接受此行为，请设置 PICTIFY_ANALYTICS_DISABLED=1，这样就不会发送任何数据。

安装来源归因

将 @pictify/mcp-server 提交到 MCP 目录时，请在安装片段中设置 PICTIFY_MCP_SOURCE，以便我们将注册归因到相应的目录条目。以下是 mcp.so 目录条目的示例：

{
  "mcpServers": {
    "pictify": {
      "command": "npx",
      "args": ["-y", "@pictify/mcp-server"],
      "env": {
        "PICTIFY_API_KEY": "your_api_key",
        "PICTIFY_MCP_SOURCE": "mcp.so"
      }
    }
  }
}

对于托管远程服务（https://mcp.pictify.io），请改为在连接器 URL 中将标识符作为查询参数传递——服务会将其保存在 OAuth 会话中：

https://mcp.pictify.io?source=mcp.so

接受的标识符：小写字母、数字、.、-、_，长度最多为 64 个字符。其他内容都会被替换为 unknown。

开发

git clone https://github.com/pictify-io/pictify-mcp.git
cd pictify-mcp
npm install
npm run build

使用 MCP Inspector 测试：

PICTIFY_API_KEY=your_key npm run inspector

许可证

MIT