redfox-tools-mcp 0.1.0__tar.gz

redfox_tools_mcp-0.1.0/.gitignore

@@ -0,0 +1,6 @@
+__pycache__/
+*.pyc
+.venv/
+dist/
+*.egg-info/
+.DS_Store

redfox_tools_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,128 @@
+Metadata-Version: 2.5
+Name: redfox-tools-mcp
+Version: 0.1.0
+Summary: RedFoxHub 工具类 MCP server: 多平台视频/作品下载与素材上传
+Project-URL: Homepage, https://github.com/redfox-data/redfox-mcp
+Project-URL: Website, https://redfox.hk/apis/?source=mcp
+License-Expression: MIT
+Keywords: download,mcp,redfox,tools,upload
+Requires-Python: >=3.10
+Requires-Dist: redfox-mcp-core>=0.1.0
+Description-Content-Type: text/markdown
+
+# redfox-tools-mcp
+
+RedFoxHub 工具类 MCP Server — 多平台作品下载与素材上传共 12 个 MCP 工具，适用于 dsh、Claude Code、Cursor 等任意 MCP 客户端。
+
+## 工具（12）
+
+| 工具 | 分类 | 说明 |
+|---|---|---|
+| `tools_download` | 下载 | 通用解析下载（任意平台作品链接） |
+| `tools_download_douyin` | 下载 | 抖音作品下载 |
+| `tools_download_kuaishou` | 下载 | 快手作品下载 |
+| `tools_download_xiaohongshu` | 下载 | 小红书作品下载 |
+| `tools_download_bilibili` | 下载 | B 站作品下载 |
+| `tools_download_wechat_channels` | 下载 | 微信视频号作品下载 |
+| `tools_download_tiktok` | 下载 | TikTok 作品下载 |
+| `tools_download_youtube` | 下载 | YouTube 视频下载 |
+| `tools_download_instagram` | 下载 | Instagram 作品下载 |
+| `tools_download_twitter` | 下载 | X(Twitter) 作品下载 |
+| `tools_upload_image` | 上传 | 上传图片（png/jpeg/webp），返回 URL |
+| `tools_upload_file` | 上传 | 上传文件（视频≤50MB / 音频≤20MB / 图像≤10MB） |
+
+上传类工具接收**本地文件路径**，由 server 打开文件后交给 SDK 上传。
+
+## 认证
+
+1. 前往 <https://redfox.hk/settings/api-keys?source=mcp> 获取 API Key
+2. 设置环境变量：
+
+```bash
+export REDFOX_API_KEY="YOUR_API_KEY"
+```
+
+未配置 key 时，每个工具都会返回结构化的获取引导。
+
+## 安装与运行（本地 stdio）
+
+需要 Python ≥ 3.10，推荐使用 [uv](https://docs.astral.sh/uv/)：
+
+```bash
+uvx redfox-tools-mcp
+```
+
+或：
+
+```bash
+pip install redfox-tools-mcp
+redfox-tools-mcp
+```
+
+## 客户端配置
+
+Claude Code：
+
+```bash
+claude mcp add redfox-tools --env REDFOX_API_KEY=YOUR_API_KEY -- uvx redfox-tools-mcp
+```
+
+Cursor / 其他 MCP 客户端：
+
+```json
+{
+  "mcpServers": {
+    "redfox-tools": {
+      "command": "uvx",
+      "args": ["redfox-tools-mcp"],
+      "env": { "REDFOX_API_KEY": "YOUR_API_KEY" }
+    }
+  }
+}
+```
+
+## 远程 HTTP 模式（多租户）
+
+适用于 MCP 市场与托管场景，每个用户携带自己的 API Key：
+
+```bash
+redfox-tools-mcp --transport http --host 0.0.0.0 --port 8000
+# 或环境变量：REDFOX_MCP_TRANSPORT=http REDFOX_MCP_HOST=0.0.0.0 REDFOX_MCP_PORT=8000
+```
+
+- MCP 端点：`http://<host>:8000/mcp`（Streamable HTTP）；健康检查：`GET /health`
+- 每个请求通过请求头 `X-API-Key: <key>`（或 `Authorization: Bearer <key>`）携带自己的 key，按 key 建独立客户端缓存，额度互不共享
+- 注意：上传类工具读取的是 **server 所在机器**的本地文件路径，远程模式下请先将文件放到服务端可访问的路径
+
+客户端配置（远程 URL + 请求头）：
+
+```json
+{
+  "mcpServers": {
+    "redfox-tools": {
+      "url": "http://<host>:8000/mcp",
+      "headers": { "X-API-Key": "ak_your_key" }
+    }
+  }
+}
+```
+
+## Docker 部署
+
+本包目录自带 Dockerfile，可独立构建部署：
+
+```bash
+cd packages/redfox-tools-mcp
+docker build -t redfox-tools-mcp .
+docker run -d -p 8000:8000 redfox-tools-mcp
+```
+
+镜像不内置任何 API Key，调用方通过请求头携带自己的 key。
+
+## 底层实现
+
+基于官方 SDK [redfox-python-sdk](https://github.com/redfox-data/redfox-python-sdk)。API 文档：<https://redfox.hk/?source=mcp>。
+
+## License
+
+MIT

redfox_tools_mcp-0.1.0/README.md

@@ -0,0 +1,116 @@
+# redfox-tools-mcp
+
+RedFoxHub 工具类 MCP Server — 多平台作品下载与素材上传共 12 个 MCP 工具，适用于 dsh、Claude Code、Cursor 等任意 MCP 客户端。
+
+## 工具（12）
+
+| 工具 | 分类 | 说明 |
+|---|---|---|
+| `tools_download` | 下载 | 通用解析下载（任意平台作品链接） |
+| `tools_download_douyin` | 下载 | 抖音作品下载 |
+| `tools_download_kuaishou` | 下载 | 快手作品下载 |
+| `tools_download_xiaohongshu` | 下载 | 小红书作品下载 |
+| `tools_download_bilibili` | 下载 | B 站作品下载 |
+| `tools_download_wechat_channels` | 下载 | 微信视频号作品下载 |
+| `tools_download_tiktok` | 下载 | TikTok 作品下载 |
+| `tools_download_youtube` | 下载 | YouTube 视频下载 |
+| `tools_download_instagram` | 下载 | Instagram 作品下载 |
+| `tools_download_twitter` | 下载 | X(Twitter) 作品下载 |
+| `tools_upload_image` | 上传 | 上传图片（png/jpeg/webp），返回 URL |
+| `tools_upload_file` | 上传 | 上传文件（视频≤50MB / 音频≤20MB / 图像≤10MB） |
+
+上传类工具接收**本地文件路径**，由 server 打开文件后交给 SDK 上传。
+
+## 认证
+
+1. 前往 <https://redfox.hk/settings/api-keys?source=mcp> 获取 API Key
+2. 设置环境变量：
+
+```bash
+export REDFOX_API_KEY="YOUR_API_KEY"
+```
+
+未配置 key 时，每个工具都会返回结构化的获取引导。
+
+## 安装与运行（本地 stdio）
+
+需要 Python ≥ 3.10，推荐使用 [uv](https://docs.astral.sh/uv/)：
+
+```bash
+uvx redfox-tools-mcp
+```
+
+或：
+
+```bash
+pip install redfox-tools-mcp
+redfox-tools-mcp
+```
+
+## 客户端配置
+
+Claude Code：
+
+```bash
+claude mcp add redfox-tools --env REDFOX_API_KEY=YOUR_API_KEY -- uvx redfox-tools-mcp
+```
+
+Cursor / 其他 MCP 客户端：
+
+```json
+{
+  "mcpServers": {
+    "redfox-tools": {
+      "command": "uvx",
+      "args": ["redfox-tools-mcp"],
+      "env": { "REDFOX_API_KEY": "YOUR_API_KEY" }
+    }
+  }
+}
+```
+
+## 远程 HTTP 模式（多租户）
+
+适用于 MCP 市场与托管场景，每个用户携带自己的 API Key：
+
+```bash
+redfox-tools-mcp --transport http --host 0.0.0.0 --port 8000
+# 或环境变量：REDFOX_MCP_TRANSPORT=http REDFOX_MCP_HOST=0.0.0.0 REDFOX_MCP_PORT=8000
+```
+
+- MCP 端点：`http://<host>:8000/mcp`（Streamable HTTP）；健康检查：`GET /health`
+- 每个请求通过请求头 `X-API-Key: <key>`（或 `Authorization: Bearer <key>`）携带自己的 key，按 key 建独立客户端缓存，额度互不共享
+- 注意：上传类工具读取的是 **server 所在机器**的本地文件路径，远程模式下请先将文件放到服务端可访问的路径
+
+客户端配置（远程 URL + 请求头）：
+
+```json
+{
+  "mcpServers": {
+    "redfox-tools": {
+      "url": "http://<host>:8000/mcp",
+      "headers": { "X-API-Key": "ak_your_key" }
+    }
+  }
+}
+```
+
+## Docker 部署
+
+本包目录自带 Dockerfile，可独立构建部署：
+
+```bash
+cd packages/redfox-tools-mcp
+docker build -t redfox-tools-mcp .
+docker run -d -p 8000:8000 redfox-tools-mcp
+```
+
+镜像不内置任何 API Key，调用方通过请求头携带自己的 key。
+
+## 底层实现
+
+基于官方 SDK [redfox-python-sdk](https://github.com/redfox-data/redfox-python-sdk)。API 文档：<https://redfox.hk/?source=mcp>。
+
+## License
+
+MIT

redfox_tools_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,31 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "redfox-tools-mcp"
+version = "0.1.0"
+description = "RedFoxHub 工具类 MCP server: 多平台视频/作品下载与素材上传"
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+keywords = ["mcp", "redfox", "tools", "download", "upload"]
+dependencies = [
+    "redfox-mcp-core>=0.1.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/redfox-data/redfox-mcp"
+Website = "https://redfox.hk/apis/?source=mcp"
+
+[project.scripts]
+redfox-tools-mcp = "redfox_tools_mcp.server:main"
+
+[tool.uv.sources]
+redfox-mcp-core = { workspace = true }
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/redfox_tools_mcp"]
+
+[tool.hatch.build.targets.sdist]
+include = ["src/redfox_tools_mcp", "README.md"]

redfox_tools_mcp-0.1.0/src/redfox_tools_mcp/__init__.py

@@ -0,0 +1,3 @@
+"""RedFox 工具类 MCP Server"""
+
+__version__ = "0.1.0"

redfox_tools_mcp-0.1.0/src/redfox_tools_mcp/__main__.py

@@ -0,0 +1,6 @@
+"""支持 python -m redfox_tools_mcp 启动"""
+
+from redfox_tools_mcp.server import main
+
+if __name__ == "__main__":
+    main()

redfox_tools_mcp-0.1.0/src/redfox_tools_mcp/server.py

@@ -0,0 +1,115 @@
+"""RedFox 工具类 MCP Server
+
+将 RedFoxHub（红狐数据平台）的多平台作品下载与素材上传能力暴露为 MCP 工具。
+
+认证：stdio 模式读环境变量 REDFOX_API_KEY；HTTP 模式从请求头
+X-API-Key（或 Authorization: Bearer <key>）取 key。
+获取地址 https://redfox.hk/settings/api-keys?source=mcp
+"""
+
+from typing import Any, Dict
+
+from redfox_mcp_core import call, create_server, get_client, serve
+
+from redfox_tools_mcp import __version__
+
+mcp = create_server("redfox-tools", __version__)
+
+
+def _upload(method: str, file: str, format: str) -> Dict[str, Any]:
+    """打开本地文件并把文件句柄交给 SDK 上传方法，异常统一转结构化结果"""
+    try:
+        handle = open(file, "rb")
+    except OSError as e:
+        return {"error": "file_error",
+                "message": f"无法读取本地文件 {file}：{e}"}
+    with handle:
+        return call(lambda: getattr(get_client().tools, method),
+                    file=handle, format=format)
+
+
+# ─── 下载 ────────────────────────────────────────────────
+
+@mcp.tool()
+def tools_download(url: str) -> Dict[str, Any]:
+    """通用作品下载：传入任意平台作品链接，自动解析返回下载信息。"""
+    return call(lambda: get_client().tools.download, url=url)
+
+
+@mcp.tool()
+def tools_download_douyin(url: str) -> Dict[str, Any]:
+    """抖音作品下载。url 为抖音作品链接（必填）。"""
+    return call(lambda: get_client().tools.download_douyin, url=url)
+
+
+@mcp.tool()
+def tools_download_kuaishou(url: str) -> Dict[str, Any]:
+    """快手作品下载。url 为快手作品链接（必填）。"""
+    return call(lambda: get_client().tools.download_kuaishou, url=url)
+
+
+@mcp.tool()
+def tools_download_xiaohongshu(url: str) -> Dict[str, Any]:
+    """小红书作品下载。url 为小红书作品链接（必填）。"""
+    return call(lambda: get_client().tools.download_xiaohongshu, url=url)
+
+
+@mcp.tool()
+def tools_download_bilibili(url: str) -> Dict[str, Any]:
+    """B 站作品下载。url 为 B 站作品链接（必填）。"""
+    return call(lambda: get_client().tools.download_bilibili, url=url)
+
+
+@mcp.tool()
+def tools_download_wechat_channels(url: str) -> Dict[str, Any]:
+    """微信视频号作品下载。url 为视频号作品链接（必填）。"""
+    return call(lambda: get_client().tools.download_wechat_channels, url=url)
+
+
+@mcp.tool()
+def tools_download_tiktok(url: str) -> Dict[str, Any]:
+    """TikTok 作品下载。url 为 TikTok 作品链接（必填）。"""
+    return call(lambda: get_client().tools.download_tiktok, url=url)
+
+
+@mcp.tool()
+def tools_download_youtube(url: str) -> Dict[str, Any]:
+    """YouTube 视频下载。url 为 YouTube 视频链接（必填）。"""
+    return call(lambda: get_client().tools.download_youtube, url=url)
+
+
+@mcp.tool()
+def tools_download_instagram(url: str) -> Dict[str, Any]:
+    """Instagram 作品下载。url 为 Instagram 帖子/Reel 链接（必填）。"""
+    return call(lambda: get_client().tools.download_instagram, url=url)
+
+
+@mcp.tool()
+def tools_download_twitter(url: str) -> Dict[str, Any]:
+    """X(Twitter) 作品下载。url 为推文链接（必填）。"""
+    return call(lambda: get_client().tools.download_twitter, url=url)
+
+
+# ─── 上传 ────────────────────────────────────────────────
+
+@mcp.tool()
+def tools_upload_image(file: str, format: str = "png") -> Dict[str, Any]:
+    """上传图片到红狐素材库。file 为本地图片文件路径（必填）；
+    format：png/jpeg/webp。返回上传后的 URL。"""
+    return _upload("upload_image", file, format)
+
+
+@mcp.tool()
+def tools_upload_file(file: str, format: str = "mp4") -> Dict[str, Any]:
+    """上传文件到红狐素材库（视频≤50MB / 音频≤20MB / 图像≤10MB）。
+    file 为本地文件路径（必填）；format 为文件扩展名（如 mp4/mp3/png）。
+    返回上传后的 URL。"""
+    return _upload("upload_file", file, format)
+
+
+def main() -> None:
+    serve(mcp, prog="redfox-tools-mcp", description="RedFox 工具类 MCP server")
+
+
+if __name__ == "__main__":
+    main()