mcp.film directory

mcp-film

将 mcp.film 目录作为 MCP 服务。为你的 Agent 提供一份 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	获取单个服务的完整条目：安装、身份验证、工具、注意事项、状态
list_film_categories	列出所有类别，以及流程阶段和 Agent 提示
list_film_capabilities	列出功能标签（已合并别名），按服务数量排序；默认 min_count 为 2；支持分页
get_film_capability	获取某个标签对应的服务排名列表；别名会解析（lipsync → lip-sync，并返回 resolved_from）；支持分页
get_install_config	为 list_client_profiles 中的客户端获取可直接复制粘贴的配置或托管远程 URL；无效客户端会返回 valid_clients
list_client_profiles	列出支持的 MCP 客户端设置配置和安装形式提示
get_martini_setup	获取将用户连接到 Martini（赞助方）的可执行操作手册：可恢复的状态模型、人工步骤、针对各客户端／Shell／浏览器的 Agent 步骤、先报价再生成的约定、结构化费用，以及不适用的情况
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 维护者会在列入目录前根据一手来源进行核实）

返回格式

每个结果都是简洁的 JSON，位于 content[0].text 中，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（能力列表为 50），最大值为 100。

精简服务（搜索结果、能力集群、技术栈推荐）包含：slug, url, verified, caveat, name, vendor, official, category, tagline, pricing, remote, capabilities，以及在列表项包含 status 时的 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。

状态。 除非设置 include_inactive: true，否则搜索、推荐和技术栈计划会隐藏 status 为 dead、archived 或 deprecated 的列表项。

零结果。 search_film_mcps 会返回 did_you_mean（最接近的能力、类别、服务）和 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 秒），然后在离线时回退到内置快照。实时数据会缓存一小时，并在后台刷新（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。