一键部署#

Fork 后部署#

Fork Tokisaki-Galaxy/bangumimcp-ts 到自己的账户，再在 Cloudflare 里连接 GitHub 仓库即可。

部署前提#

• 一个 Cloudflare 账号
• 一个 GitHub 仓库连接

search#

一个入口搜索三类对象：条目、人物、角色。

它支持 scope 限定搜索范围，也支持分页和筛选参数。模型一般先搜索，再决定要不要展开详情。

get_subject#

条目详情入口。它不只返回标题和简介。

还可以通过 include 展开这些内容：

• persons
• characters
• relations
• episodes

这样模型可以一次拿到主信息和关联信息，减少来回调用。

get_user#

用户画像入口。

它会返回用户资料和收藏快照，适合看“这个人平时看什么、收藏什么、偏好什么”。

get_calendar#

放送表入口。

如果你想查今天或本周有哪些番在播，这个工具最直接。

update_collection#

这是唯一的写入口。

我把“收藏条目”“改进度”“收藏人物”“收藏角色”统一到一个入口里，再由 target_type 严格分流。

• target_type=subject 才能用 subject_status / progress / rating / comment
• target_type=person 或 target_type=character 只能用 favorite

这样可以避免模型把无关参数混着传。

get_person#

人物详情入口。它会同时带出人物相关作品和角色信息。

get_character#

角色详情入口。它会同时带出出演作品和声优相关信息。

manage_index#

目录管理入口，但默认关闭。

只有显式开启环境变量后，它才会出现在工具列表里。

部分失败不会炸全局#

像 get_subject、get_user、get_person、get_character 这种聚合工具，内部会并行拉多个子接口。

如果其中某个子请求失败，不会直接打断整次调用，而是把那一段结果标成 _error。

这样模型还能继续使用其余可用信息。

写参数会严格校验#

update_collection 不会再“尽量帮你猜”。

如果参数组合不合法，直接返回 invalid_argument。

这对模型很重要。静默忽略会让它误以为自己写成功了。

nsfw_filter 会正常透传#

搜索角色时，如果用户没有 token，Bangumi 本身会忽略 NSFW 过滤条件，而不是报错。

所以这个 MCP 会把参数原样传下去，让后端按权限处理。