FrameThrower

FrameThrower MCP Server

エージェントの中で、映画の参考資料を。 あらゆる MCP クライアントを、 照明、レンズの特性、ショットサイズ、色、ムードを基準にフレーム単位で インデックス化された 5,489 本の映画の撮影参考ライブラリに接続できます。

会話の中でイメージを伝えると、エージェントが映画名、監督、撮影監督を 明記した実際のフレームを提示します。

https://framethrower.ai/api/mcp

リモートサーバー、OAuth 2.1、4 つのツール、レート制限なし、 登録時に $2 分のクレジットが無料（カード不要）。

---

クイックスタート

Claude（デスクトップ／Web）

設定 → コネクター → カスタムコネクターを追加 → 次を貼り付けます。

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 をご覧ください。

---

4 つのツール

ツール	クレジット	機能
search_frames	2	自然言語で、コンセプト、ムード、色、構図、シーンを基準に検索します
find_by_craft	2	レンズ、ショットサイズ、スタイル、設定、時間帯、監督、年など、撮影技法の属性を基準にフレームを検索します
find_similar	2	すでに候補に選んだフレームに似たフレームをさらに探します。絞り込みに使います
get_frame_details	2	1 つのフレームの完全なメタデータ、サムネイル、リンクを取得します

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. 検索 — エージェントが、説明された内容を使って search_frames を呼び出します。
2. いくつか提示 — 映画名、監督、リンクを添えて、4 件ほどを提示します。大量に並べることはありません。
3. 反応 — 「#2 に似たものをもっと」「もっと寒色で」「もっとタイトに」などと伝えます。それに応じて、そのフレームを指定した find_similar、または属性を調整した find_by_craft が実行されます。
4. 繰り返す — ぴったりの結果が見つかるまで続けます。

チャット内での画像表示は安定しないため、すべての結果に FrameThrower へのリンクが付いています。 フレーム本来の見た目を確認できるのはギャラリーです。

効果的な会話例は examples/prompts.md をご覧ください。

---

料金

登録時に $2 分のクレジットが無料、カードは不要です。 その後は $1 で 1,000 クレジット、 ツールの呼び出し 1 回につき 2 クレジットなので、$1 で 500 回呼び出せます。 クレジットに有効期限はありません。レート制限もありません。

クレジットがなくなると、残高とチャージ先を含むメッセージがツールから返されます。 そのため、エージェントは何も言わずに失敗するのではなく、状況を説明できます。

返されるもの — 返されないもの

ツールが返すのは、メタデータ、サムネイル URL、カラーパレット、FrameThrower に戻るディープリンクです。生の画像データは返しません。

これは画像配信パイプラインではなく、発見と参照のためのツールです。フレームのライセンスを付与する権利は当社にはありません。解説、教育、研究の参考資料として低解像度で表示されるものであり、権利は所有者に留保されます。使用目的をご覧ください。

---

サーバーコードがない理由

FrameThrower MCP サーバーはリモートでホストされています。接続して使用するものであり、自分で実行する必要はありません。そのため、このリポジトリにはコネクター、マニフェスト、クライアントごとのセットアップ、ツールのシグネチャ、実例が含まれています。インストールするものも、実行し続けるものも、管理する API キーもありません。OAuth により、エージェントはサインイン済みの FrameThrower アカウントとして動作します。

---

こちらもご利用いただけます

• REST API — 11 個のエンドポイント、レート制限なし。 機械可読な仕様 · ドキュメント
• npm SDK — npm install framethrower-ai (ソース)

同じアカウント、同じクレジットです。

---

概要

FrameThrower は、これからのクリエイターのためのリファレンスアプリです。インターネット上でも最大級の映画スチルライブラリの 1 つであり、REST API、MCP サーバー、npm SDK から呼び出せます。現役の映画制作者や広告クリエイターを対象に、経験豊富な映画制作者や広告クリエイターが開発しました。

framethrower.ai · /mcp

MIT ライセンスです。