FrameThrower

FrameThrower MCP 服务

电影参考素材，尽在你的 Agent 中。 将任意 MCP 客户端连接到一个拥有 5,489 部电影 的电影摄影参考库，逐帧按灯光、镜头特性、景别、色彩和氛围编入索引。

在对话中描述你想要的视觉风格，Agent 就会提供真实画面，并注明影片、导演和摄影指导。

https://framethrower.ai/api/mcp

远程服务、OAuth 2.1、四种工具、无速率限制、注册即送 $2 额度，无需银行卡。

---

快速开始

Claude（桌面版 / 网页版）

设置 → 连接器 → 添加自定义连接器 → 粘贴：

https://framethrower.ai/api/mcp

浏览器打开后登录即可。

Cursor

一键添加：

或添加到 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "framethrower": {
      "url": "https://framethrower.ai/api/mcp"
    }
  }
}

仅支持 stdio 的客户端

通过 mcp-remote 桥接，它会为你处理 OAuth 流程：

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

各客户端的完整操作步骤见 docs/install.md。

---

四种工具

工具	额度	功能
search_frames	2	使用自然语言，按概念、氛围、色彩、构图或场景搜索
find_by_craft	2	按电影摄影属性查找画面——镜头、景别、风格、场景、时段、导演、年份
find_similar	2	查找与已加入候选列表的画面相似的更多画面。这是细化流程
get_frame_details	2	获取单帧的完整元数据、缩略图和链接

search_frames

参数	类型	说明
query	string，必填	例如："neon-lit rainy street at night"
limit	number，1–40	默认值为 12

find_by_craft

所有参数均为可选，可组合使用以缩小范围。

参数	类型	说明
lens	string	"anamorphic"、"spherical"、"vintage_soft"
shot_size	string	"closeup"、"wide"、"medium"
visual_style	string
setting	string	"interior" 或 "exterior"
time_of_day	string	"night"、"day"
director	string
year_min / year_max	number	年份范围
limit	number，1–40	默认值为 12

find_similar

参数	类型	说明
frameId	string，必填	之前搜索结果中的 ID
limit	number，1–40	默认值为 12

get_frame_details

参数	类型	说明
frameId	string，必填

---

预期使用方式

连接时，服务端会发送使用说明，因此客户端无需额外告知该如何操作。它推荐的流程如下：

1. 搜索——Agent 根据你的描述调用 search_frames。
2. 展示几个结果——大约四个，每个都附有影片、导演和链接，而不是一股脑全发出来。
3. 反馈——“多找几个像 #2 的”“再冷一些”“景别更紧一些”。这会对该画面调用 find_similar，或调整属性后调用 find_by_craft。
4. 重复，直到找到合适的结果。

每条结果都会附上返回 FrameThrower 的链接，因为聊天中的内嵌图片渲染并不可靠，而在图库中查看才能呈现画面的真实效果。

有效对话示例见 examples/prompts.md。

---

费用

注册即送 $2 额度，无需银行卡。 之后 $1 可兑换 1,000 额度，每次工具调用消耗 2 额度，因此 $1 可调用 500 次。额度永不过期，且没有速率限制。

额度用完后，工具会返回一条说明信息，其中包括你的余额和充值方式，这样 Agent 就能向你解释原因，而不会悄无声息地失败。

---

它会返回什么——以及不会返回什么

工具会返回元数据、缩略图 URL、色彩调色板，以及指向 FrameThrower 的深度链接。绝不会返回原始图像字节。

这是一个发现和参考工具，而非图像交付渠道。这些画面不归我们所有，无法由我们授权——它们会以较低分辨率呈现，供评论、教育和学习参考，版权仍归其所有者所有。请参阅预期用途。

---

为什么这里没有服务端代码

FrameThrower MCP 服务是远程托管的——你连接到它，而不是自行运行它。因此，这个仓库提供的是连接器：清单、各客户端的设置、工具签名和完整示例。无需安装，也无需保持运行，更无需管理 API 密钥——借助 OAuth，Agent 会以你已登录的 FrameThrower 账户身份操作。

---

另有提供

• REST API — 11 个端点，无速率限制。 机器可读规范 · 文档
• npm SDK — npm install framethrower-ai (源代码)

使用同一账户和同一积分。

---

关于

FrameThrower 是面向未来创作者的参考应用：它是互联网上规模最大的电影剧照库之一，可通过 REST API、MCP 服务和 npm SDK 调用。由资深电影人和广告创意人士打造，服务于电影行业从业者。

framethrower.ai · /mcp

采用 MIT 许可证。