MCP 接入：让 AI Agent 调用哼哼猫提取接口

哼哼猫提供托管的 MCP server（Model Context Protocol，Streamable HTTP）。配好之后，你在 Claude Code、Codex、Cursor 里直接说「帮我提取这个链接里的视频和图片」，AI 就会调用哼哼猫接口，不需要写代码。与 REST API 用同一个 API Key、同一套计费、同一份限流配额。

端点：https://api.meowload.net/mcp

鉴权：Authorization: Bearer <你的 API Key>，与 REST 接口同一把 Key。

开始之前

先到开发者管理中心获取你的 API Key。

下面所有配置里的 <你的 API Key> 都是占位符，必须换成你自己的真实 Key。原样粘贴在配置时不会报错，但客户端一连接就会收到 401，工具列表里不会出现哼哼猫的工具。

Claude Code

claude mcp add --transport http meowload https://api.meowload.net/mcp --header "Authorization: Bearer <你的 API Key>"

默认只在执行命令的那个目录生效。想让所有项目都能用，加 -s user。

Codex

# ~/.codex/config.toml
[mcp_servers.meowload]
url = "https://api.meowload.net/mcp"
bearer_token_env_var = "MEOWLOAD_API_KEY"

bearer_token_env_var 填的是环境变量名：Codex 启动时读取 MEOWLOAD_API_KEY 的值，自动以 Authorization: Bearer <值> 的形式发送。先在 shell 里设置这个变量（如 export MEOWLOAD_API_KEY=<你的 API Key>），Key 就不用写进配置文件。

不想用环境变量，也可以把请求头直接写进配置：

# ~/.codex/config.toml
[mcp_servers.meowload]
url = "https://api.meowload.net/mcp"
http_headers = { "Authorization" = "Bearer <你的 API Key>" }

~ 指你的用户主目录，文件不存在就自己新建。改完需要重启 Codex。

通用 JSON 配置（Cursor 等）

Cursor 写进 ~/.cursor/mcp.json（全局生效）或项目根目录的 .cursor/mcp.json（仅该项目）。其他客户端参考各自文档里 MCP 配置文件的位置。

{
  "mcpServers": {
    "meowload": {
      "url": "https://api.meowload.net/mcp",
      "headers": { "Authorization": "Bearer <你的 API Key>" }
    }
  }
}

改完需要重启客户端。

确认连上了

Claude Code 在终端执行：

claude mcp list

看到 meowload 且状态为已连接即成功，也可以在会话里输入 /mcp 查看。其他客户端一般在设置的 MCP 面板里能看到这个 server——列出下面 5 个工具就说明通了。

可用工具

工具	作用
`extract_post`	提取单个帖子的媒体直链与元数据
`extract_playlist`	提取主页 / 频道 / 播放列表的一页，支持翻页
`extract_subtitles`	提取视频的字幕轨道与下载直链
`get_credits`	查询剩余额度
`get_docs`	在 Agent 内直接读本站开发者文档

三个提取工具与 REST 接口同价、只在成功时扣次数，get_credits 与 get_docs 免费。

三个提取工具返回的响应与 API 参考里对应端点完全一致，字段说明也在那里。

提取工具返回的是媒体的直链与元数据，不是文件本身。 要真正存到本地，让你的 Agent 拿到链接后再下载一次即可，多数客户端可以直接做到。直链是短效的，拿到后尽快下载。

extract_playlist 一次只取一页：结果里 has_more 为 true 时，把 next_cursor 作为 cursor 参数再调一次取下一页。

get_docs 的 page 参数可选 quickstart、migration、errors、mcp 四个值，lang 可选 zh、en，让 Agent 自己查字段含义和错误码。

额度

余额、充值与预警设置都在开发者管理中心。额度用尽时提取工具会返回 Insufficient credits 与充值地址。计费规则也在那里的「计费规则」。

连不上怎么办

现象	多半是
连接失败或返回 `401`	`<你的 API Key>` 没换成真实 Key，或漏了 `Bearer` 前缀（`Bearer` 与 Key 之间有一个空格）
配置改了但工具没出现	没重启客户端
返回 `429`	触发限流。MCP 与 REST API 共用每个 Key 每分钟 1200 次的配额。
工具返回错误码	与 REST 相同的 `code` 与 `retryable`，含义见错误码

下一步

快速开始：用 REST 方式调用同一套接口
API 参考：完整端点文档，可在线调试
错误码：工具返回的错误码含义

试试对你的 Agent 说：「提取这个 YouTube 视频的 1080p 直链和中文字幕：https://...」