RedFox MCP Server

Los 115 Agent Skills del repositorio redfox-community se encapsulan como un único servidor MCP (opción 2: todas las herramientas se despliegan y están disponibles de una sola vez).

• 91 herramientas invocables directamente (ya conectadas a la API real de RedFox)

• Cero dependencias: implementación nativa pura en Node.js (fetch integrado), sin necesidad de npm install, sin Python

• Protocolo: MCP (Model Context Protocol) sobre stdio, compatible con clientes como Qoder / Claude / Cursor

{
  "mcpServers": {
    "redfox-mcp-server": {
      "command": "npx",
      "args": ["-y", "redfox-mcp-server@latest"],
      "env": { "REDFOX_API_KEY": "your-api-key-here" }
    }
  }
}

Despliegue en la plaza MCP de ModelScope (despliegue alojado)

La plaza MCP de ModelScope admite el despliegue alojado de este servidor como un servicio MCP en la nube, proporcionando una URL remota exclusiva (SSE / Streamable HTTP) para que los usuarios puedan conectarse de forma remota sin ejecutarlo localmente.

1. Publicar el paquete npm (solo la primera vez)

cd redfox-mcp
npm login           # 需要 npm 账号
npm publish         # 包名 redfox-mcp-server，零依赖，37KB

2. Crear el servicio en ModelScope

Entra en la página de creación (o crea rápidamente desde el repositorio de GitHub) y completa:

La detección del despliegue de la plataforma ejecuta npx -y redfox-mcp-server@latest y llama a tools/list (ya probado: devuelve 91 herramientas sin necesidad de API Key, por lo que la detección pasa sin problemas).

3. Uso por parte del usuario

El usuario introduce su propia REDFOX_API_KEY en la página de detalles del servicio → hace clic en «Conectar» → obtiene su URL remota exclusiva:

https://mcp-<uuid>.api-inference.modelscope.cn/sse

Rellénala en cualquier cliente MCP (Qoder / Dify / Tongyi Lingma, etc.) para usar de forma remota las 91 herramientas completas.

Límites del despliegue gratuito: máximo 20 servicios desplegados por usuario, 1 instancia por servicio, ≤500 solicitudes en una ventana de 5 segundos para todos los servicios gratuitos, y ≤50000 solicitudes en total por usuario.

Related MCP server: rednote-analyzer-mcp

Inicio rápido

1. Obtener la API Key

Ve a RedFox hub para obtener la REDFOX_API_KEY.

2. Iniciar el servidor

# Windows PowerShell
$env:REDFOX_API_KEY = "ak_xxxx..."
node server.js

3. Configurar en el cliente

Qoder: añade este servidor en la configuración de MCP (tras publicarlo se puede usar el método npx; para desarrollo local se usa el método node):

• Método npx (recomendado, requiere que el paquete npm esté publicado):

  {
    "mcpServers": {
      "redfox-mcp-server": {
        "command": "npx",
        "args": ["-y", "redfox-mcp-server@latest"],
        "env": { "REDFOX_API_KEY": "ak_xxxx..." }
      }
    }
  }

• Método de desarrollo local:

  {
    "mcpServers": {
      "redfox-mcp": {
        "command": "node",
        "args": ["E:\\path\\to\\redfox-mcp\\server.js"],
        "env": { "REDFOX_API_KEY": "ak_xxxx..." }
      }
    }
  }

El archivo de registro de Qoder (SERVER_METADATA.json + tools/*.json) se encuentra en qoder-register/, generado automáticamente por gen-qoder-register.js.

Claude Desktop / Cursor: claude mcp add redfox-mcp -- node <path>/server.js

Lista de herramientas

Arquitectura

redfox-mcp/
├── server.js              # MCP stdio 服务器入口（JSON-RPC 2.0）
├── tools-manifest.json    # 自动提取的工具清单（从仓库脚本提取 API 端点/参数）
├── src/
│   ├── redfox-client.js   # RedFox API 统一客户端（双请求头、错误处理、任务轮询）
│   ├── build-tools.js     # 工具构建器（合并 manifest + overrides）
│   └── overrides.js       # 人工校正层（精确参数映射、异步任务定义）
└── qoder-register/        # Qoder 注册文件（SERVER_METADATA.json + tools/*.json）

Flujo de datos

MCP 客户端 ──JSON-RPC/stdio──> server.js ──> build-tools.js 工具注册表
                                                │
                                                ▼
                                    redfox-client.js（X-API-KEY 双发）
                                                │
                                                ▼
                                    https://redfox.hk/story/api/...

Diseño de parámetros de las herramientas

• Los nombres de los parámetros coinciden con los campos del payload de la API de RedFox (camelCase: startDate/pageNum/pageSize)

• El campo source lo rellena automáticamente el servidor con RedFoxMCP, sin necesidad de que el llamador lo pase

• Las herramientas de tareas asíncronas (generación de vídeo / extracción de texto de vídeo / obtención de comentarios) se envían y se consultan automáticamente, devolviendo directamente el resultado final

Regenerar la lista de herramientas

Tras actualizar los scripts del repositorio, vuelve a extraer la información de la API:

node mcp-extract-manifest.js "E:\path\to\redfox-community"
copy tools-manifest.json redfox-mcp\tools-manifest.json
node gen-qoder-register.js   # 重新生成 Qoder 注册文件

Herramientas no integradas (24)

Los siguientes Skills no tienen endpoint de API (son de análisis con IA / tipo prompt puro) y no se han registrado como herramientas:

ai-intelligence-investigator, image-gen, redfox-skill-generator, redfox-subscribe, multi-copywrite-alchemy, pdf-image-text-extractor, seedream-5-lite, gzh-search, gzh-subscribe, video-downloader, douyin-works-crawler, tiktok-home-downloader, geo-analyzer, global-ai-news-brief, overseas-trending-search, wechat-account-analyzer, weibo-video-downloader, twitter-work-search, xiaohongshu-lowtop, etc.

Si necesitas integrarlas, puedes añadir los endpoints correspondientes en src/overrides.js y regenerar.

Preguntas frecuentes

P: La llamada a la herramienta devuelve [NO_API_KEY]? R: No se ha establecido la variable de entorno REDFOX_API_KEY; configúrala antes de iniciar.

P: Devuelve [BIZ_ERROR]? R: La API Key no es válida o no tiene permisos suficientes; comprueba el estado de la Key en RedFox hub.

P: ¿Cómo probar?

node mcp-test-client.js list   # 列出工具
node mcp-test-client.js call douyin-search test-args.json   # 调用工具（参数从 JSON 文件读）