mcp.film directory

mcp-film

MCP サーバーとしての mcp.film ディレクトリです。AI 映画制作で知っておくべき MCP サーバーをすべて把握できるよう、エージェントに一覧を提供します。機能で検索でき、コピーして貼り付けられるインストール設定と、パイプライン全体のプランナーを利用できます。

claude mcp add mcp-film -- npx -y mcp-film

ホスト型エンドポイントにも接続できます。同じツールをローカルインストールなしで利用できます。

claude mcp add --transport http mcp-film https://mcp.film/mcp

MCP 2025-11-25、2025-06-18、2025-03-26 に対応しています（提示されたバージョンが不明な場合は、最新バージョンが使われます）。initialize は簡潔な instructions を返します。まず recommend_film_mcps(brief) を使ってください。

ツール

ツール	機能
recommend_film_mcps	自由記述の概要に最適なルートと、最初に接続するサーバーを照合します。まずハード制約（constraints オブジェクトまたは概要内の語句）を適用し、次に関連性を評価します。confidence で概要との一致度を確認できます
search_film_mcps	トークン化され、エイリアスを認識する検索です（lipsync = lip-sync = lip sync、tts = text to speech、4k = upscale）。カテゴリ、機能、公式、リモートで絞り込み、ページ分けして表示します
get_film_mcp	1 つのサーバーの詳細情報です。インストール、認証、ツール、注意点、ステータスを確認できます
list_film_categories	パイプラインの各段階とエージェント向けヒントを含む、すべてのカテゴリを表示します
list_film_capabilities	機能タグをサーバー数の多い順に表示します（エイリアスは統合）。デフォルトの min_count は 2 です。ページ分けして表示します
get_film_capability	1 つのタグに対応するサーバーを順位順に表示します。エイリアスも解決され（lipsync → lip-sync、resolved_from で元のタグを示します）、ページ分けして表示します
get_install_config	list_client_profiles にあるクライアント向けのコピー可能な設定、またはホスト型リモート URL を返します。無効なクライアントを指定すると valid_clients を返します
list_client_profiles	対応する MCP クライアントのセットアッププロファイルと、インストール形式のヒントを表示します
get_martini_setup	ユーザーを Martini（スポンサー）に接続するための実行可能な手順書です。再開可能な状態モデル、ユーザーの手順、クライアント／シェル／ブラウザーごとのエージェントの手順、見積もり優先の生成契約、構造化されたコスト、利用すべきでない場合を含みます
get_catalog_pulse	運用状況を表示します。情報の鮮度、確認待ちの項目、キュレーターの作業予定、機械向けのインターフェースを含みます。demand_signals と martini_growth_checks はキュレーター／運用向けのセクションで、名前を指定した場合のみ返されます
list_film_playbooks	よくある AI 映画制作の作業向けに、厳選された制作スタックのレシピをページ分けして表示します
get_film_playbook	主要サーバー、セットアップ順序、認証要件、手順、制約、代替手段を含むプレイブック全体を表示します
list_film_recommendations	よくある映画制作の作業向けに、意図に応じた MCP の候補一覧をページ分けして表示します
get_film_recommendation	役割、理由、代替手段、Martini への引き継ぎガイダンスを含む、推奨内容の全体を表示します
plan_film_stack	概要（機能、タグライン、説明）に応じて候補を調整し、パイプラインの各段階に推奨サーバーを提示します
submit_listing	新しいサーバーを提案します。検証後、公開中のレジストリと重複がないか確認し、すぐに GitHub issue として登録できる形式のペイロードを返します（掲載前に mcp.film のメンテナーが一次情報を確認します）

レスポンスの形式

すべての結果は、content[0].text にコンパクトな JSON 形式で格納され、structuredContent にも同じオブジェクトが格納されます。

リスト（search_film_mcps、get_film_capability、 list_film_capabilities、list_film_playbooks、list_film_recommendations） には、count、total、limit、offset、next_offset、truncated が含まれます。 データが黙って切り捨てられることはありません。次のページを取得するには、offset: next_offset を渡してください。 デフォルトの limit は 20（capabilities の場合は 50）、最大値は 100 です。

コンパクトなサーバー情報（検索結果、capability クラスター、スタック候補）： slug, url, verified, caveat, name, vendor, official, category, tagline, pricing, remote, capabilities。リストに status が含まれる場合は、それも含まれます。 caveat は、エントリーの caveats[0]、または検証ログ以外のノートの最初の文です。 get_film_mcp は常に完全なエントリーを返します。

おすすめ候補（recommend_film_mcps）：primary_servers[] とそのエイリアス primary[] には {slug, name, role, why, remote, official, verified, status?, caveats?} が格納され、fallback_servers[] には {slug, name, remote, official, verified, status?} が格納されます。完全なサーバーオブジェクトを取得するには、verbosity: "full" を渡してください。 各ルートには match: {score, strength} が含まれ、レスポンスには confidence （strong | fair | weak）が含まれます。Martini が主要候補に含まれる場合、または依頼に本番環境の状態が含まれる場合、ルートには martini_handoff（文章）と martini_handoff_structured（when, not_when, first_calls, install {mcp, cli}, signup_url, setup_tool, tracked_url, disclosure）が含まれます。

制約（recommend_film_mcps）：constraints: {local_only, no_upload, hosted_only, has_shell, free_only, os}。また、「ローカルで」「アップロードせずに」「機密」「オフライン」「予算なし」「無料ツール」「ローカルにインストールせずに」などの表現からも推定されます。制約に違反する候補はスコアリング前に除外され、excluded_by_constraints に名前が記載されます。該当する候補がない場合、レスポンスは no_match となり、unsatisfied_constraints と relevant_routes が含まれます。

ステータス。 status が dead、archived、または deprecated のリスト項目は、include_inactive: true を指定しない限り、検索、おすすめ、スタックプランから除外されます。

結果が 0 件の場合。 search_film_mcps は did_you_mean（最も近い capabilities、categories、servers）と hint を返します。不明な category または capability は、valid_categories / did_you_mean を含むエラーになります。

仕組み

依存関係はありません。ライブのレジストリ https://mcp.film/api/registry.min.json と本番用プレイブック https://mcp.film/api/playbooks.json、さらにおすすめルート https://mcp.film/api/recommendations.json と稼働状況 https://mcp.film/api/pulse.json をそれぞれ 5 秒のタイムアウトで取得し、その後、オフライン時は同梱スナップショットにフォールバックします。ライブデータは 1 時間キャッシュされ、バックグラウンドで更新されます（MCP_FILM_CACHE_TTL_MS）。MCP_FILM_OFFLINE=1 を指定するとスナップショットのみが提供され、MCP_FILM_API_BASE を指定すると取得先を別のホストに変更できます。 get_catalog_pulse は data_source と observed_at を報告します。データは継続的にキュレーションされ、再検証されています。 github.com/c47-inc/mcp-film。

MIT。