Original Pictures

originalpictures-mcp：用于 C2PA Content Credentials、AI 水印和验证的 MCP 服务

originalpictures-mcp 是 Original Pictures 官方的 Model Context Protocol 服务。它通过一组范围受限的工具，让 AI 助手和 Agent（Claude Desktop、Claude Code、Cursor 和其他 MCP 客户端）为媒体添加 C2PA Content Credentials 签名、不可见水印和指纹，并验证文件所声明的来源。

ORIGINALPICTURES_API_KEY=opk_... \
ORIGINALPICTURES_MCP_SCOPES=assets:read,jobs:read,recipes:read,verifications:read \
uvx originalpictures-mcp

它是基于类型化 originalpictures-sdk 构建的适配器。它提供经过审核的读取工作流、两个需要明确确认且幂等的写入操作（sign 和 create_verification），以及 verify_public，用于将本地文件与公开验证页面进行匿名比对。它不会代理任意 API 路由，也无法访问数据库、对象存储、工作进程、签名器或基础设施。

功能

• 使用 C2PA 签名（sign）：为上传的资产启动签名任务。每个任务都会按照 C2PA Technical Specification 2.4 写入 C2PA 清单（Content Credentials）；watermark 和 fingerprint 用于选择是否添加不可见水印和感知指纹。
• 声明 AI 生成：sign 接受 ai_declaration，这是一种机器可读标记，其形式见于《欧盟 AI 法案》第 50(2) 条和《加州 AI 透明度法案》（SB 942）。
• 验证（create_verification、get_verification、verify_public）：报告 Content Credentials 状态、声明的来源，以及账户是否有该文件的记录。这绝不代表对内容本身的判断。
• 读取账户信息（list_assets、list_jobs、get_usage、get_pricing 等）。

优势

• 最小权限。 只有当某个工具的作用域包含在 ORIGINALPICTURES_MCP_SCOPES 中时，该工具才会启用。API 还会独立执行密钥获授的作用域限制。
• 费用可预期。 两个按量计费的工具会在描述和 _meta["com.originalpictures/billing"] 中显示“费用预览”，要求提供完全匹配的 confirmation 字符串，并接受 max_billable_operations，以拒绝启动的计费操作超出你所设上限的调用。
• 工具提示清晰。 每个工具都会明确设置 title、readOnlyHint、destructiveHint、idempotentHint 和 openWorldHint。
• 媒体不会进入对话。 媒体字节不会通过工具参数或结果传输。

安装

无需单独安装即可运行：

uvx originalpictures-mcp

也可以安装：

pipx install originalpictures-mcp

需要 Python 3.12 或更高版本。

快速开始

1. 在 控制台 的 API keys 下创建专用 API 密钥，并仅授予助手所需的作用域。
2. 将服务添加到 MCP 客户端。

Claude Desktop（claude_desktop_config.json）和 Cursor（~/.cursor/mcp.json）使用相同的 mcpServers 条目：

{
  "mcpServers": {
    "originalpictures": {
      "command": "uvx",
      "args": ["originalpictures-mcp"],
      "env": {
        "ORIGINALPICTURES_API_KEY": "opk_...",
        "ORIGINALPICTURES_API_BASE_URL": "https://api.originalpictures.com",
        "ORIGINALPICTURES_MCP_SCOPES": "assets:read,jobs:read,recipes:read,verifications:read"
      }
    }
  }
}

Claude Code：

claude mcp add originalpictures \
  -e ORIGINALPICTURES_API_KEY=opk_... \
  -e ORIGINALPICTURES_API_BASE_URL=https://api.originalpictures.com \
  -e ORIGINALPICTURES_MCP_SCOPES=assets:read,jobs:read \
  -- uvx originalpictures-mcp

3. 例如，可以让助手执行：“列出我最近签名的 5 个资产。”

工具

工具	权限范围	备注
get_current_user	identity:read
list_assets, get_asset, list_receipts, get_signing_receipt	assets:read
list_jobs, get_job, list_recipes	jobs:read
get_recipe	recipes:read
get_usage	billing:read
get_pricing	billing:read	为每项计费操作定价的版本化费率。
list_verifications, get_verification_history	verifications:read
get_verification	recovery:read
create_verification	verify:write	计费操作。confirmation 必须严格为 verify:<object_id>。
sign	sign:write	计费操作。对已上传的 asset_id 签名；必须设置 watermark 和 fingerprint 标志。confirmation 必须严格为 sign:<asset_id>。
verify_public	verify:write	仅限 STDIO。读取一个绝对本地文件（最多 25 MB，且不能包含符号链接），并在不使用 API 密钥的情况下，将其与 verify 页面 slug 进行校验。

sign 在调用 API 前会拒绝同时传入 ai_declaration 和 watermark: true： "AI 生成标记需要单独调用签名（C2PA 声明计划）"。媒体通过 SDK、CLI 或 REST API 上传；sign 会为签名启动一项计费操作，并为所选的水印和指纹各启动一项计费操作。

示例

1. 只读助手（安全默认设置）

ORIGINALPICTURES_API_KEY=opk_... \
ORIGINALPICTURES_MCP_SCOPES=assets:read,jobs:read,recipes:read,verifications:read \
uvx originalpictures-mcp

有效提示词示例："本周我的哪些作业失败了，原因是什么？"、"显示资产 ast_… 的签名收据"、"每张图片的水印费用是多少？"（需具备 billing:read 权限）。

2. 带支出限制的签名助手

将 sign:write 添加到权限范围中。当助手调用 sign 时，必须传入 confirmation: "sign:<asset_id>"，并且可以通过 max_billable_operations 限制单次调用：

{
  "asset_id": "ast_…",
  "watermark": true,
  "fingerprint": true,
  "idempotency_key": "mcp-sign-2026-11-07-001",
  "confirmation": "sign:ast_…",
  "max_billable_operations": 3
}

3. 将本地文件与公开验证页面进行核对

在作用域中包含 verify:write 且使用默认 STDIO 传输方式时，verify_public 会读取一个 本地绝对路径，并根据页面 slug（例如 studio-nova）进行核对，不会发送 API 密钥。结果会说明文件声明的来源，以及页面所有者的系统是否有相关记录；请同时显示其 statement。每次核对都会向页面所有者计费。此功能不通过 HTTP 提供，因为远程服务绝不能自行读取其所在主机上的文件。

4. 改用托管服务（无需本地安装）

API 也提供相同的工具，地址为 https://api.originalpictures.com/mcp（无状态 Streamable HTTP，Authorization: Bearer opk_...），并提供上传工具，供没有本地文件的 Agent 使用。请参阅托管 MCP 服务。

5. 在环回地址上运行自己的 HTTP 端点

ORIGINALPICTURES_API_KEY=opk_... \
ORIGINALPICTURES_MCP_SCOPES=assets:read,jobs:read \
ORIGINALPICTURES_MCP_REMOTE_TOKEN='a-long-random-secret' \
originalpictures-mcp --transport http --host 127.0.0.1 --port 8000

MCP bearer 令牌与上游 API 密钥不同。明文 HTTP 仅接受字面形式的 IPv4/IPv6 环回地址或 localhost；在服务器启动前，会拒绝通配符、局域网、公共地址以及其他主机名绑定。需要远程访问时，请在同一主机上的环回监听器前配置一个经过单独审核的 TLS 终止器。不支持传统 SSE 和 WebSocket 传输方式。

配置

变量	含义	默认值
ORIGINALPICTURES_API_KEY	API 密钥（必需的服务器端机密）	无
ORIGINALPICTURES_MCP_SCOPES	以逗号分隔的工具作用域允许列表	空：不启用任何工具
ORIGINALPICTURES_API_BASE_URL	API 来源	https://api.originalpictures.com
ORIGINALPICTURES_MCP_REMOTE_TOKEN	--transport http 的 Bearer 令牌（16 至 4096 个字符）	无
ORIGINALPICTURES_MCP_DEFAULT_DEADLINE_SECONDS	每次调用的默认截止时间	20
ORIGINALPICTURES_MCP_MAX_DEADLINE_SECONDS	调用可请求的最长截止时间（最多 120）	120
ORIGINALPICTURES_MCP_MAX_OUTPUT_BYTES	单个工具结果的大小上限（1 KiB 至 1 MiB）	262144
ORIGINALPICTURES_MCP_MAX_PAGE_SIZE	列表页的最大大小（1 至 100）	100

命令行选项：--transport（stdio，默认值，或 http）、--host、--port（默认值为 8000）和 --path（默认值为 /mcp）。

工作原理

1. MCP 客户端启动 originalpictures-mcp（STDIO），或连接到它（HTTP）。
2. 服务仅列出作用域包含在 ORIGINALPICTURES_MCP_SCOPES 中的工具。
3. 每次工具调用都会在本地进行检查（作用域、参数范围、确认字符串、计费操作上限），然后通过 originalpictures-sdk 使用你的密钥发送到 API。
4. API 会强制执行密钥自身的作用域、配额和支出上限，并返回大小受限的结果 （最多为 ORIGINALPICTURES_MCP_MAX_OUTPUT_BYTES）。

故障排除

症状	可能原因及解决方法
客户端未显示任何 Original Pictures 工具	ORIGINALPICTURES_MCP_SCOPES 为空或拼写错误；至少列出一个范围。
ORIGINALPICTURES_API_KEY is required	客户端的 env 区块中缺少密钥。
工具返回身份验证错误	密钥已撤销或过期；在控制台中创建新密钥。
工具返回权限错误	密钥缺少该工具所需的范围；本地允许列表未授予相应范围。
sign 在发出任何请求前遭拒	confirmation 不是精确的 sign:<asset_id>，或调用超出 max_billable_operations。
--transport http 拒绝启动	主机不是回环地址，或者缺少 ORIGINALPICTURES_MCP_REMOTE_TOKEN，或其长度不足。
找不到 uvx	安装 uv，或使用 pipx install originalpictures-mcp。

常见问题

这是 C2PA 吗？ 是。签名会写入标准 C2PA 清单（Content Credentials），任何支持 C2PA 的验证器（例如 c2patool）都能读取。Original Pictures 已列入 C2PA 合规产品列表，作为 C2PA 合规计划 0.2 （C2PA 技术规范 2.4）下的生成器产品。

Original Pictures 通过了审计吗？ Original Pictures Technologies, Inc. 持有 ISO/IEC 27001:2022 信息安全管理体系认证 （GCAI，证书 GCAI-ISMS-PD91）和 ISO/IEC 42001:2023 AI 管理体系认证 （TNV）。截至 2026 年 10 月 19 日，该公司已获得 Percilchofe CPA LLC 出具的 SOC 2 Type I 报告， 并运行 GDPR 合规计划。这些认证涵盖管理体系，不涵盖此软件包。请参阅安全与合规。

它会存储我的媒体吗？ MCP 服务本身不会存储任何内容。上传到 Original Pictures 的文件会在专用服务器上处理，在传输和静态存储时加密，并在隔离环境中处理；已发布的输出会根据你的 API 密钥所选的保留期限保存。运营人员只能查看元数据，紧急访问会经过审计。这是专用服务器处理，不是端到端加密。

支持哪些格式？ JPEG、PNG、WebP、TIFF、AVIF、WAV、MP3、AAC（.m4a）和 MP4（H.264/AAC）支持嵌入式 C2PA；GIF、JPEG XL、SVG、DNG、HEIC/HEIF、QuickTime、AVI 和 FLAC 仅支持嵌入签名；PDF、EPUB、DOCX、文本、字体和 ML 模型文件支持旁置 .c2pa 清单。list_recipes 会显示你的部署所提供的选项。

助手能否未经询问就花钱？ 只有在你添加 sign:write 或 verify:write 后才可以；即便如此，每次可计费调用仍需要精确的确认字符串。请使用 max_billable_operations 和设有支出上限的密钥。

费用是多少？ 请参阅定价，或让助手调用 get_pricing。

如何获取 API 密钥？ 登录控制台，然后在 API keys 下创建密钥。

链接

• 文档：https://docs.originalpictures.com/
• 托管的 MCP 服务：https://docs.originalpictures.com/integrations/mcp-remote/
• API 参考：https://docs.originalpictures.com/api/
• 网站：https://originalpictures.com
• 支持：[email protected]

许可证

根据 Apache License, Version 2.0 授权；完整文本位于此软件包附带的 LICENSE 文件中。版权所有 © 2026 Original Pictures Technologies, Inc. 此许可证不授予使用 Original Pictures 名称或徽标的任何权利。