MCP服务

xylplm2025/8/9大约 7 分钟

🤖 Media Saber-MCP 简介

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

🎯 项目定位

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

核心优势：

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

2. 功能一览

功能	说明	示例
🗣️ 自然语言订阅	解析影片名、年份、季数	`订阅复仇者联盟 2012`
🎬 多类型支持	电影 / 电视剧 / 动漫	`订阅权力的游戏 S01`
🌐 本地服务	零配置局域网访问	支持标准 streamable-http 协议连接

🚀 快速上手

📋 前置条件

在使用MCP服务前，需要先配置OpenAI API相关设置：

前往基础设置页面
在 "智能体配置" 部分配置以下项目：
- 🔗 OpenAI API URL：如 https://api.openai.com/v1
- 🔑 OpenAI API Key：您的API密钥
- 🤖 默认模型：如 gpt-3.5-turbo 或 gpt-4
- ✅ 启用 MCP：开启此选项

⚙️ 启动MCP服务

MCP服务已内置于Media Saber后端服务中，无需额外配置环境变量即可使用。

⚠️ 注意

旧版本中的环境变量 MS_MCP_SERVER_HTTP_ADDR 已废弃，无需再配置该变量。MCP服务现在直接集成在后端服务中。

确认已在基础设置中启用MCP后，在智能体页面的"新增MCP服务列表"中将会看到：

🎬 媒体服务
📦 MS 媒体服务：包含媒体、订阅、站点、媒体服务、云存储、系统等服务

🔩 内置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`	推荐电视剧（支持按年代、地区、类型、排序筛选）

☁️ 云存储 & 下载

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

🔧 系统相关

工具名称	说明
`test_network`	网络连接测试
`get_zspace_system_state`	获取极空间系统状态和硬件信息

🔌 第三方客户端连接

🔗 连接地址

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 配置（一键导入）

如果您使用的客户端支持通过JSON导入MCP配置（如Cherry Studio、Cline、Claude Desktop等），可以直接使用以下JSON配置：

{
  "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"
      }
    }
  }
}