MCP服务

xylplm2025/8/9大约 8 分钟

🤖 Media Saber-MCP 简介

💬 一个基于 MCP（Model Context Protocol）的本地电影 / 电视剧订阅服务，让订阅像聊天一样简单。

📦 Skills 技能包

如果您是第一次接触Media Saber的技能系统，推荐先查看Skills 技能包文档了解所有可用的技能和工具。本文档主要讲解MCP服务的配置和单个工具的详细说明。

🎯 项目定位

Media Saber-MCP 把「我想看」变成「已订阅」—— 只需一句话，系统就能帮你追踪影片更新、自动入库，并实时推送状态。

核心优势：

🏠 完全本地化 - 无需注册、无需云同步
🔒 隐私可控 - 数据完全掌握在自己手中
⚡ 速度飞快 - 本地处理，即时响应

2. 功能一览

功能	说明	示例
🗣️ 自然语言订阅	解析影片名、年份、季数	`订阅复仇者联盟 2012`
🎬 多类型支持	电影 / 电视剧 / 动漫	`订阅权力的游戏 S01`
🏆 榜单浏览	按平台、分类、主题查看榜单	`查看豆瓣电影榜单`
🖥️ NAS 状态	多品牌 NAS 硬件信息查询	`查看NAS系统状态`
🌐 本地服务	零配置局域网访问	支持标准 streamable-http 协议连接

🚀 快速上手

💡 提示

MCP服务已内置于Media Saber后端服务中，无需额外配置环境变量即可使用内置的 MS MCP服务（包含媒体、订阅、站点、媒体服务、云存储、系统等能力）。

🔩 内置MCP工具一览

Media Saber MCP服务内置了丰富的工具，涵盖媒体管理、订阅、站点、云存储、系统等多个方面。

💡 提示

以下工具列表仅供参考，具体可用工具请以实际MCP服务返回为准。

🎬 媒体相关

工具名称	说明
`search_tmdb`	搜索电影/电视剧 TMDB 信息
`get_tmdb_info`	获取电影/电视剧 TMDB 详细信息
`get_media_status`	查询媒体状态（已发布站点、是否已入库等）
`get_miss_episodes`	查询媒体库中有漏集的电视剧
`get_media_servers`	查询媒体服务列表
`sync_libraries`	同步媒体库

📺 订阅相关

工具名称	说明
`subscribe_movie`	订阅电影，订阅后自动搜索、下载
`subscribe_tv`	订阅电视剧，支持指定季数、起始集数、指定集数
`refresh_subscribe`	刷新订阅列表，立即开始搜索下载

🌐 站点相关

工具名称	说明
`get_sites`	查询站点列表
`get_site_data`	查询站点数据
`today_site_data`	查询站点今日数据汇总（上传量、下载量等）
`total_site_data`	查询站点总数据统计（上传、下载、魔力、做种等）
`get_site_message`	查询站点消息
`get_site_notice`	查询站点公告
`sync_site_data`	同步站点数据
`sync_site_message`	同步站点消息
`sync_site_notice`	同步站点公告
`site_sign_in`	站点签到
`test_site`	站点连通性测试
`test_site_rss`	站点 RSS 测试
`update_site_configs`	更新站点适配文件

🎯 推荐相关

工具名称	说明
`recommend_movies`	推荐电影（支持按年代、地区、类型、排序筛选）
`recommend_tvs`	推荐电视剧（支持按年代、地区、类型、排序筛选）

🏆 榜单相关

工具名称	说明
`rank_media_sources`	查询榜单平台列表
`rank_categories`	按榜单平台查询分类列表
`rank_subjects`	按榜单分类查询主题列表
`rank_items`	按榜单分类和主题查询媒体列表（支持分页）

☁️ 云存储 & 下载

工具名称	说明
`add_offline_download`	添加云下载任务（支持 ed2k、magnet 链接）
`cloud_share_receive`	云存储转存（支持 115 资源链接）

🔧 系统 & NAS 相关

工具名称	说明
`test_network`	网络连接测试
`get_nas_info`	获取所有已启用 NAS 实例的系统状态与硬件信息（CPU、内存、存储、网络、GPU、风扇、电源等，支持极空间、绿联、飞牛、PVE，支持多设备）

💡 NAS 支持说明

支持设备：极空间、绿联、飞牛、PVE
系统消息推送：极空间、绿联、飞牛支持系统消息推送
多设备支持：所有 NAS 信息都支持多设备，可同时管理和查看多台 NAS 的状态
使用方式：在修仙秘籍中安装对应设备的服务助手即可体验

🔌 第三方客户端连接

🔗 连接地址

MCP服务现在直接通过Media Saber后端服务提供，有两种连接方式：

方式一：使用容器默认端口（推荐）

直接使用容器对外暴露的端口（如8888），加上 /message 路径即可：

http://IP:8888/message

方式二：使用后端内部端口

后端服务默认监听 22698 端口，Docker中默认未映射该端口，需要自行添加端口映射：

# Docker 端口映射示例
-p 22698:22698

映射后连接地址为：

http://IP:22698/message

💡 提示

推荐使用方式一，无需额外映射端口，直接复用已有的服务端口即可。

⚙️ 客户端手动配置

在可以使用的MCP客户端中添加服务：

➕ 选择手动添加
📝 填入连接地址：如 http://192.168.1.100:8888/message
🔧 配置请求头：
- 字段名：Authorization
- 字段值：Bearer 您的API_KEY

📋 MCP JSON 配置（一键导入）

如果您使用的是 Cline、Claude Desktop 等采用通用 MCP 配置结构的客户端，可以直接使用以下 JSON：

若您使用 Cherry Studio，请参考下方“Cherry Studio 导入格式示例”。

{
  "mcpServers": {
    "MediaSaber": {
      "transport": "streamable-http",
      "url": "http://IP:端口/message",
      "headers": {
        "Authorization": "Bearer 您的API_KEY"
      }
    }
  }
}

示例（假设Media Saber地址为 192.168.1.100:8888，API KEY为 sk-xxxx）：

{
  "mcpServers": {
    "MediaSaber": {
      "transport": "streamable-http",
      "url": "http://192.168.1.100:8888/message",
      "headers": {
        "Authorization": "Bearer sk-xxxx"
      }
    }
  }
}

🍒 Cherry Studio 导入格式示例

Cherry Studio 用于导入的 JSON 结构与通用 MCP 配置略有不同（如使用 baseUrl、type: streamableHttp 等字段），可参考以下格式：

{
  "mcpServers": {
    "MvZt2NGC-JQRWGi-4t6dT": {
      "name": "MediaSaber",
      "description": "",
      "baseUrl": "http://IP:端口/message",
      "command": "",
      "args": [],
      "env": {},
      "isActive": true,
      "type": "streamableHttp",
      "headers": {
        "Authorization": "Bearer 您的API_KEY"
      }
    }
  }
}