# ddys-mcp

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

## 功能

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

## 安装

```bash
npx -y ddys-mcp
```

需要 HTTP 服务时：

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

## Claude Desktop

```json
{
  "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`：

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

## HTTP

streamable HTTP 地址默认是：

```text
http://127.0.0.1:3333/mcp
```

旧 SSE 兼容端点默认保留：

```text
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`。