ddys-mcp

低端影视 API 的官方 Model Context Protocol 服务。它把 DDYS 的搜索、分类、详情、资源、合集、分享、评论、求片、STRM、M3U 和通知生成能力暴露给 Claude Desktop、Cursor、Cline/Roo Code、VS Code MCP 等客户端。

功能

• 搜索、联想、最新、热门、分类、日历、字典。
• 详情、播放线路、下载/网盘/磁力资源、相关推荐、评论。
• 合集、分享、求片、公开动态、用户资料。
• 登录态能力：我的资料、创建求片、评论、删除评论、反馈失效资源、关注/取消关注。
• 导出能力：STRM 文件清单、M3U 播放列表、中文通知文案。
• 传输方式：stdio、streamable HTTP，并保留旧 SSE 端点。

安装

npx -y ddys-mcp

需要 HTTP 服务时：

npx -y ddys-mcp --http --host 127.0.0.1 --port 3333

Claude Desktop

{
  "mcpServers": {
    "ddys": {
      "command": "npx",
      "args": ["-y", "ddys-mcp"],
      "env": {
        "DDYS_API_BASE": "https://ddys.io/api/v1",
        "DDYS_SITE_BASE": "https://ddys.io",
        "DDYS_API_KEY": ""
      }
    }
  }
}

Cursor

.cursor/mcp.json：

{
  "mcpServers": {
    "ddys": {
      "command": "npx",
      "args": ["-y", "ddys-mcp"],
      "env": {
        "DDYS_RESOURCE_LIMIT": "8",
        "DDYS_INCLUDE_EXTERNAL": "true"
      }
    }
  }
}

HTTP

streamable HTTP 地址默认是：

http://127.0.0.1:3333/mcp

旧 SSE 兼容端点默认保留：

http://127.0.0.1:3333/sse
http://127.0.0.1:3333/messages

环境变量

变量	默认值	说明
DDYS_API_BASE	https://ddys.io/api/v1	DDYS API 地址
DDYS_SITE_BASE	https://ddys.io	详情页、海报等站点地址
DDYS_API_KEY	空	登录态工具使用
DDYS_RESULT_LIMIT	20	默认结果数量
DDYS_PAGE_SIZE	24	默认分页大小
DDYS_RESOURCE_LIMIT	8	默认资源数量
DDYS_EXPORT_LIMIT	50	M3U 导出最大条目
DDYS_DIRECT_ONLY	false	只返回直链资源
DDYS_INCLUDE_EXTERNAL	true	是否包含外部网页/网盘资源
DDYS_TIMEOUT_MS	15000	API 超时毫秒数
DDYS_CACHE_TTL_MS	600000	GET 缓存时间
DDYS_MCP_TRANSPORT	stdio	stdio 或 http
DDYS_MCP_HOST	127.0.0.1	HTTP 监听地址
DDYS_MCP_PORT	3333	HTTP 端口
DDYS_MCP_PATH	/mcp	HTTP MCP 路径

工具

ddys_health、ddys_latest、ddys_hot、ddys_search、ddys_suggest、ddys_category、ddys_calendar、ddys_dictionaries、ddys_detail、ddys_resources、ddys_related、ddys_comments、ddys_collections、ddys_collection_detail、ddys_shares、ddys_share_detail、ddys_requests、ddys_create_request、ddys_activities、ddys_user_profile、ddys_me、ddys_create_comment、ddys_delete_comment、ddys_report_invalid_resource、ddys_follow、ddys_generate_strm、ddys_generate_m3u、ddys_generate_notification。

资源

• ddys://latest
• ddys://hot
• ddys://dictionaries
• ddys://movie/{slug}
• ddys://movie/{slug}/sources
• ddys://search/{query}
• ddys://category/{type}
• ddys://collection/{slug}

提示词

ddys_find_by_type、ddys_make_watchlist、ddys_write_notification、ddys_generate_media_exports、ddys_compare_resources。