关于 SceneF — California + Hawaii Movie Showtimes
SceneF 是面向影迷及其助手的只读电影场次 MCP 服务,覆盖加州、佛罗里达州和夏威夷的区域看板。它整合影院日程与第三方数据源,并提供来源和时效信息。
主要功能
- 01按影片、影院、日期或时间搜索场次
- 02按日期或时段排列影片
- 03查询影院和影片详情
- 04按条件规划观影之夜
- 05查找折扣和即将上映影片
- 06查看场次时效与核验记录
适用场景
- 01查找某城市或街区附近的场次
- 02比较指定时段内的放映时间
- 03规划观影前查看影院折扣
- 04核对场次信息的来源和时效
MCP 相关
通过托管的流式 HTTP MCP 服务和本地 stdio 服务提供十种只读工具。两种方式均可访问区域看板,且无需 API 密钥。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://scenef.com/mcpclaude mcp add --transport http scenef-san-francisco-movie-showtimes https://scenef.com/mcp{"mcpServers":{"scenef-san-francisco-movie-showtimes":{"type":"http","url":"https://scenef.com/mcp"}}}在 Cursor 中打开{"servers":{"scenef-san-francisco-movie-showtimes":{"type":"http","url":"https://scenef.com/mcp"}}}在 VS Code 中打开{"mcpServers":{"scenef-san-francisco-movie-showtimes":{"type":"http","url":"https://scenef.com/mcp"}}}{"mcpServers":{"scenef-san-francisco-movie-showtimes":{"serverUrl":"https://scenef.com/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
10| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| when | string | 否 | 查询时间:"tonight"(默认)、"tomorrow"、"weekend"(本周的周五/周六/周日)或 YYYY-MM-DD 日期。 |
| genres | array | 否 | 类型筛选,例如 ["horror", "comedy"]。 |
| region | string | 否 | 要读取的区域看板:使用看板 ID,例如 "sf"、"oahu" 或 "miami",而不是城市名("Honolulu" 或 "Chicago" 会被拒绝)。省略时默认为 "sf"(旧金山);不会根据你所在的位置推断。查询城市、ZIP 或街区时,请先调用 scenef_resolve_board;不带 region 调用 scenef_now 会列出所有 ID。未知区域会报错,不会回退到默认值。 |
| formats | array | 否 | 格式/标签筛选,例如 ["35mm", "70mm", "qa", "live-score"]。 |
| max_results | integer | 否 | 最多返回的影片数(默认 12,上限 25)。 |
| response_format | enum | 否 | 输出大小。"concise"(默认)为精简文本加结构化摘要。在 whats_playing 中,每部影片包含总放映场次 showtime_count、next_showtime,以及仅包含下一场放映的 showtimes 数组;"detailed" 会添加放映场次行,包含 ID、票务 URL 和准确性元数据,整个答案约 200 条。film_details 和 search_showtimes 在 "concise" 模式下返回最近的 40 场放映,在 "detailed" 模式下最多返回 200 场。showtime_count 始终是总数,showtimes_complete 表示数组是否包含全部场次;要查找其余场次,请按日期或影院缩小范围。concise | detailed |
详细介绍
SceneF — 加利福尼亚州、佛罗里达州和夏威夷州的电影放映时间(MCP server)
由影迷打造,为影迷及其助手服务。
SceneF 起步于旧金山——这座仍是顶级观影城市之一的地方: 这里有 20 世纪 20 年代的单厅社区影院、每晚更换的经典影片排片表、 35mm 和 70mm 胶片、午夜场,当然也有多厅影院。如今,它在加利福尼亚州、佛罗里达州和 夏威夷州运营 56 个区域看板——从洛杉矶到萨克拉门托,从圣迭戈到毛伊岛,从迈阿密到彭萨科拉。 每个看板都会汇集影院排片和第三方放映时间数据服务,并提供来源可信度和数据新鲜度信息, 方便调用方了解这些排片信息的依据。
远程 MCP 服务,使用可流式传输的 HTTP,无需 API 密钥,只读;本仓库也提供本地 stdio 服务,运行相同的十个工具。
除 scenef_resolve_board 外,每个工具都需要 region——例如 "sf"、"la-central"、"oahu"、
"sacramento"……省略该参数时会使用默认看板(sf),绝不会根据你所在的位置进行
猜测。要查询指定地点,请使用 scenef_resolve_board;不带 region 调用
scenef_now 可查看当前看板列表。
时间采用各影院所在地点的本地时间:夏威夷时间比太平洋时间早两到三个小时,且不实行夏令时;每个看板都会随数据报告其时区。
https://scenef.com/mcp
连接
Claude Code
claude mcp add --transport http scenef https://scenef.com/mcp
Claude Desktop / 任意 MCP 客户端(.mcp.json / 客户端配置)
{
"mcpServers": {
"scenef": {
"type": "http",
"url": "https://scenef.com/mcp"
}
}
}
此外,它也已列入官方 MCP 注册表,名称为 com.scenef/showtimes。
或在本地运行
本仓库也提供一个本地 MCP 服务——使用 Node 和 stdio,不经过代理。它自行实现 该协议,并通过 SceneF 的公共 REST API 读取相同的看板数据。 两种传输方式都提供相同的十个公共工具和匹配规则。REST 缓存可能会导致两种方式的响应短暂不同。
npx -y github:speedwarnsf/scenef-mcp
Claude Desktop / 任意 stdio 客户端
{
"mcpServers": {
"scenef": {
"command": "npx",
"args": ["-y", "github:speedwarnsf/scenef-mcp"]
}
}
}
从克隆的仓库运行,或使用 Docker
npm install && npm start
docker build -t scenef-mcp . && docker run --rm -i scenef-mcp
无需 API 密钥、账号或配置。它会发送 User-Agent: scenef-mcp-local/1.1,只发出 GET 请求,并且完全没有写入路径。
npm test 首先会根据保存的托管架构契约和测试数据源进行离线回归测试。test/contract.js 会针对
实时看板调用全部十个工具,并根据服务公布的输出架构验证每个负载;test/parity.js 则会比较此服务的工具定义与托管端点的定义。要在本地预览时使用,请同时设置
SCENEF_BASE_URL=http://localhost:3017 和
SCENEF_MCP_URL=http://localhost:3017/mcp。离线运行成功并不代表已刷新外部架构。如果预览数据集有限,
请将 SCENEF_PARITY_REGION=oahu(或其他数据已填充的非默认看板)设为区域探测所用的看板;默认值为 la-central。
工具
| 工具 | 回答的问题 |
|---|---|
scenef_whats_playing | 今晚/明天/周末/某个日期的影片排名——如果时间范围涵盖今晚,会以 今晚值得关注 开头:附有依据的稀缺信息(实测座位数、最后几场、仅有的一场 35/70mm 胶片放映、已公布的折扣、现场活动) |
scenef_search_showtimes | 某部影片或某家影院的场次,可按日期和严格的时间条件筛选 |
scenef_theater_info | 某家影院的信息:地址、所在街区、长期折扣、即将上映的排片 |
scenef_film_details | 年份、片长、分级、演员、预告片、最近的即将开映场次 |
scenef_plan_movie_night | 输入限制条件(时间范围、类型、放映格式、影院),生成观影计划 |
scenef_discounts | 全部影院的优惠时段 |
scenef_coming_soon | 接下来即将上映的影片 |
scenef_resolve_board | 将城市、邮编、街区或别名映射到覆盖该地点的排片板;或说明拒绝的具体原因 |
scenef_now | 即时快照:此刻还能赶上的放映 |
scenef_accuracy | 我们自己的核验记录——已执行、失败和无法访问的检查 |
排片查询工具一次只针对一个地区排片板作答——传入 region
来选择。请原样保留返回的所有票务、日历和影片 URL,
包括地区路径和 ?region= 提示。无效的严格日期/时间筛选条件
会返回拒绝响应和警告,绝不会不加筛选地返回成功结果。不含广告,也不付费排名。艺术影院和连锁影院享有同等展示待遇——街区影院仅有的一场
35mm 胶片放映,正是这个服务旨在呈现的信息,不论影院位于 Richmond 还是 Hilo。
scenef_whats_playing 在简洁模式下返回 showtime_count 总场次数,以及
showtimes 中的下一场放映;详细模式会增加场次条目,整份回答约有 200 条。scenef_film_details 和
scenef_search_showtimes 在简洁模式下返回最近的 40 场放映,在详细模式下最多返回 200 场。showtime_count 始终是总场次数,而
showtimes_complete 会说明数组是否包含全部场次;要查看更多场次,请按日期或影院缩小范围。
为什么值得信赖
- 放映时间来自影院排期和第三方放映时间数据服务。许多放映时间,包括大多数连锁影院和部分独立影院的放映时间,来自该服务,而非影院本身;这些信息会标记为
source_tier: licensed-feed,在本站的可信度最低。无论是简洁模式还是详细模式,每场返回的放映都会包含confidence、source_tier、sources和verified_at。 data_as_of是数据集的发布时间。verified_at和freshness描述某场放映的信息来源证据;较新的数据集仍可能包含较早的记录。新鲜度衡量的是信息的时效性,而非正确性。依赖过时或保留的放映信息前,请向影院确认。- 验证记录公开可查,包括未通过的检查:scenef.com/api/accuracy。
本地 scenef_now.sources 摘要以与托管服务相同的方式统计影院状态,逐家影院统计,并使用托管服务的措辞列出放映信息可能过时的影院。它从每条放映信息的 freshness.source_status 中读取状态,因此,未在排期板上显示任何放映信息的影院在本地不可见,也不会计入;托管服务的统计数字可能会包含这些影院,载荷中的 basis 和正文末尾的 Data: 行会说明这一点。除该行、下方的边缘缓存说明以及输入验证错误外(MCP SDK 对这些错误的措辞有所不同,但限制相同),所有回答的正文都与托管服务逐字一致。两种传输方式下,每场放映的新鲜度都来自规范 REST 数据源;本地服务保留该数据源的许可信息、retained 和 source_status,并像托管服务一样,在调用时根据 verified_at 计算 age_hours 和 status。
REST 接口通过边缘缓存提供服务:副本过期后,边缘缓存会先用过期副本响应下一个请求,同时刷新副本。托管服务读取当前数据集,因此不会看到这样的副本。若边缘缓存报告副本过期,本地服务会再次请求(三次重试,耗时约三秒);若此后边缘缓存仍在提供过期副本,回答将基于该副本生成,并在页脚后用一行说明这一点,且 data_as_of 为该副本的时间。
更倾向于使用纯 HTTP?
同一数据也以 REST 风格提供——完整规范见
scenef.com/agents:
/api/listings ·
/ask ·
OpenAPI ·
llms.txt
联系方式
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。