Stockfilm MCP

Stockfilm MCP服务器

搜索并授权217000多个20世纪30年代至80年代的正宗复古家庭电影片段。

Stockfilm是可供授权的最大的复古家庭电影素材库。此MCP服务器允许AI代理直接通过 模型上下文协议.

每一个片段都是美国和世界各地普通家庭拍摄的真正的8毫米、速8或16毫米电影。专业扫描、数字恢复（除尘/划痕、稳定、色彩校正），并用元数据编目，包括拍摄年份、位置和描述性标签。 没有人工智能生成的内容。每一帧都是真正的档案电影。

______________________________________________________________________

快速开始

克劳德代码（一个命令）

claude mcp add --transport http stockfilm https://api.stockfilm.com/mcp

克劳德桌面版

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "stockfilm": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.stockfilm.com/mcp"]
    }
  }
}

Cursor/Windsurf/其他MCP客户端

Server URL: https://api.stockfilm.com/mcp
Transport:  Streamable HTTP
Auth:       None required

______________________________________________________________________

档案中有什么

217000+剪辑 在所有类别中。大多数镜头来自美国，欧洲、亚洲和拉丁美洲也有大量国际报道。

为什么这段视频很重要

• 无可替代 -这些是独一无二的家庭电影，无法重现
• 真实的 -真实的胶片纹理、时代色彩、原始纵横比得以保留
• 修复 -专业4K扫描与数字恢复
• 记载 -元数据包括拍摄年份、地点和描述性标签
• 许可的 -每个剪辑免费、全球、永久许可

______________________________________________________________________

可用工具

MCP服务器公开了6个工具：

search_vintage_footage （免费）

使用可选的年份范围和位置过滤器按文本查询搜索存档。

"Find 1960s California family barbecue footage"
"Christmas morning clips from the 1950s"
"Beach vacation footage, 1940s to 1960s"

参数：

• query （必填）-自然语言搜索。描述最佳结果。
• limit （可选）-结果数量，1-50。默认值：10。
• year_from （可选）-最早年份过滤器（例如1950年）。
• year_to （可选）-最新年份过滤器（例如1969年）。
• location （可选）-位置过滤器（城市、州或国家）。

get_clip_details （免费）

获取特定剪辑的完整元数据：标题、描述、持续时间、标签、缩略图URL、定价和许可证URL。

参数：

• clip_id （必填）-搜索结果中的剪辑ID。

find_similar_footage （免费）

通过提供剪辑ID来查找视觉上相似的剪辑。使用视觉相似性匹配来查找具有相似内容、调色板或场景组成的镜头。

参数：

• clip_id （必填）-剪辑ID，用于查找类似的镜头。
• limit （可选）-结果数量，1-25。默认值：10。

build_rough_cut （免费）

根据自然语言描述，将定时的复古片段序列自动组装成视频时间线。返回具有持续时间的剪辑的有序列表。非常适合创建编辑列表、故事板或情绪卷轴。

参数：

• query （必填）-视频序列的描述（例如，“20世纪60年代美国公路旅行暑假”）。
• target_seconds （可选）-目标时间线长度（秒），20-600。默认值：60。
• pace （可选）-编辑速度：“慢”（4-8s/剪辑）、“平衡”（3-6s/剪辑）和“快”（2-4s/剪辑）。默认值：“平衡”。
• year_from / year_to （可选）-年份范围过滤器。

check_clip_rights （免费）

在许可之前，请验证剪辑是否符合特定的预期用途。

参数：

• clip_id （必填）-要检查的剪辑ID。
• intended_use （可选）-以下选项之一：“商业”、“编辑”、“广播”、“数字”、“ai_training”。默认值：“商业”。

license_clip （10美元）

许可一个剪辑下载。返回用于支付的x402协议端点。付款通过以下方式处理 x402 在Solana或Base上使用USDC。

参数：

• clip_id （必填）-要许可的剪辑ID。

______________________________________________________________________

定价

许可条款： 免版税，全球范围内，永久，一次性购买。用于商业项目、纪录片、编辑内容、数字媒体和人工智能培训数据集。

______________________________________________________________________

x402协议集成

许可终结点使用 x402协议 （V2）用于即时、无需信任的支付。任何与x402兼容的代理或钱包都可以在没有API密钥或注册的情况下许可剪辑。

运作原理

1. 客服电话 GET /x402/clip/{clip_id}/license
2. 服务器返回HTTP 402 PAYMENT-REQUIRED 头球
3. 代理人的x402客户签署USDC支付授权
4. 代理重试 PAYMENT-SIGNATURE 头球
5. 服务器通过协助者进行验证和结算，返回许可证+下载URL

支持的网络

直接x402端点（无需MCP）

# Search (free, no auth)
curl "https://api.stockfilm.com/x402/search?q=beach+1960s&limit=5"

# Clip details (free)
curl "https://api.stockfilm.com/x402/clip/120818702"

# Rights check (free)
curl "https://api.stockfilm.com/x402/clip/120818702/rights?intended_use=commercial"

# License (returns 402 with payment instructions)
curl "https://api.stockfilm.com/x402/clip/120818702/license"

______________________________________________________________________

建筑

此MCP服务器是嵌入Stockfilm代理API（Rust/Axum）中的远程可流式HTTP服务器。它不需要本地安装——代理直接通过HTTPS连接。

Agent (Claude, GPT, etc.)
  |
  | MCP Streamable HTTP
  v
api.stockfilm.com/mcp
  |
  | Internal API calls
  v
Stockfilm Agent API (Rust/Axum)
  |
  +-- Search (PostgreSQL full-text + visual embeddings)
  +-- Rights verification
  +-- x402 payment processing (facilitator-mediated)
  +-- License management
  +-- Download token generation

发现端点

______________________________________________________________________

完全代理API

除了MCP之外，Stockfilm还提供了一个完整的代理名API，其中包含HMAC-SHA256请求签名、多步骤许可工作流、webhook和TypeScript/Python SDK：

• API基础： https://api.stockfilm.com
• 认证： API密钥+HMAC-SHA256突变签名
• 付款轨道： Solana USDC、Solana SOL、闪电BTC
• 文件： stockfilm.com/for-ai-agents

______________________________________________________________________

关于Stockfilm

Stockfilm专门制作真实的档案家庭电影片段——这种片段无法由人工智能重建或在工作室中重新制作。每一卷都是由真实的家庭拍摄的真实电影，捕捉了20世纪中叶生活的真实时刻。

档案包括来自美国和世界各地的镜头：郊区社区、家庭度假、节日庆祝活动、学校活动、公路旅行、城市街道，以及一个只存在于电影中的时代的日常生活。

网站： stockfilm.com 浏览剪辑： stockfilm.com/browse 热门剪辑： stockfilm.com/popular 精选藏品： stockfilm.com/策划 代理文件： stockfilm.com/for-ai-agents 联系人： stockfilm.com/contact

______________________________________________________________________

许可证

MCP服务器包装器是MIT许可证下的开源软件。

档案片段本身是通过Stockfilm按片段授权的专有内容。每次购买剪辑都会授予指定用途的免版税、全球永久许可。