MCP 接入配置
让你的 AI Agent 直接查询素材。选择你的 Agent,复制配置即可使用。
https://mcp.res.opentaptap.dev/mcp
选择你的 AI Agent
配置文件:.mcp.json(项目根目录)
{
"mcpServers": {
"opentaptap-resource": {
"type": "http",
"url": "https://mcp.res.opentaptap.dev/mcp"
}
}
}
在项目根目录创建 .mcp.json 文件,粘贴上述内容。Claude Code 启动后自动加载。也可用 claude mcp add 命令添加。
配置文件:~/.codex/config.toml
[mcp_servers.opentaptap-resource]
type = "http"
url = "https://mcp.res.opentaptap.dev/mcp"
在用户目录 ~/.codex/config.toml 中追加上述段落。Codex 使用 TOML 格式。
配置文件:cline_mcp_settings.json
{
"mcpServers": {
"opentaptap-resource": {
"disabled": false,
"timeout": 30,
"type": "http",
"url": "https://mcp.res.opentaptap.dev/mcp"
}
}
}
在 VS Code 中通过 Cline 扩展打开 MCP 设置,或编辑 cline_mcp_settings.json。Cline 额外支持 disabled 和 timeout 字段。
配置文件:.cursor/mcp.json(项目根目录)
{
"mcpServers": {
"opentaptap-resource": {
"type": "http",
"url": "https://mcp.res.opentaptap.dev/mcp"
}
}
}
在项目根目录创建 .cursor/mcp.json,Cursor 会自动识别。
配置文件:.opencode.json(项目根目录)
{
"mcpServers": {
"opentaptap-resource": {
"type": "http",
"url": "https://mcp.res.opentaptap.dev/mcp"
}
}
}
在项目根目录创建 .opencode.json,OpenCode 启动时自动加载。
适用于 Claude Desktop、Hermes、OpenClaw 等
{
"mcpServers": {
"opentaptap-resource": {
"type": "http",
"url": "https://mcp.res.opentaptap.dev/mcp"
}
}
}
该 JSON 格式被多个客户端共用(Claude Desktop 放入 claude_desktop_config.json)。如果你的 Agent 支持 HTTP 类型 MCP,直接粘贴即可。
| Agent | 配置文件 | 格式 |
|---|---|---|
| Claude Desktop | claude_desktop_config.json | JSON |
| Claude Code | .mcp.json(项目根) | JSON |
| Cursor | .cursor/mcp.json | JSON |
| Cline | cline_mcp_settings.json | JSON |
| OpenCode | .opencode.json | JSON |
| Codex | ~/.codex/config.toml | TOML |
可用工具(6 个)
search_assets
搜索/浏览素材包列表,支持关键字、分类、标签、格式过滤与分页。
q? category? tags? format? page? size?
get_pack
按 slug 获取素材包详情,含标签和下载直链,可选返回文件列表。
slug* with_files? page? size?
list_categories
获取全部分类列表,含名称和素材包数量。
list_tags
获取全部标签,可按分组过滤(style / type / content / format)。
group? enum
get_file
按 ID 获取单文件元数据 + 下载直链,可直接下载。
id* number
suggest
输入关键字后返回匹配的标签名和素材包名,用于自动补全。
q* string
连接测试
常见问题
MCP 服务器需要认证吗?
不需要。当前 MCP 服务器为公开服务,所有工具均可直接调用,无需 API Key 或 OAuth 认证。
返回的下载直链可以直接下载吗?
可以。所有 r2_url、preview_url、sample_url 字段均为完整的 HTTPS 直链(前缀 https://api.res.opentaptap.dev/),可直接用于下载或嵌入。
素材的版权协议是什么?
全部素材采用 CC0 1.0(公有领域)协议,可自由用于商业和非商业项目,无需署名。
支持哪些传输协议?
当前使用 Streamable HTTP 传输(推荐),兼容 Claude Code、Cursor、Cline、OpenCode、Codex 等主流客户端。不支持旧版 SSE 传输。
有调用频率限制吗?
服务部署在 Cloudflare Workers 上,受 Cloudflare 平台级速率限制保护。正常使用无需担心,建议合理使用分页参数避免一次拉取过多数据。
如何在本地开发时使用?
将配置中的 url 替换为本地地址即可,例如 http://localhost:8787/mcp。运行 wrangler dev 启动本地服务后,确保 Agent 配置指向本地端口。