RedFox MCP Server

Die 115 Agent Skills des redfox-community-Repositories werden als ein einziger MCP-Server gekapselt (Variante 2: alle Tools nach einmaliger Bereitstellung nutzbar).

• 91 Tools direkt aufrufbar (bereits an die echte RedFox-API angebunden)

• Null Abhängigkeiten: reine native Node.js-Implementierung (eingebautes fetch), kein npm install, kein Python erforderlich

• Protokoll: MCP (Model Context Protocol) über stdio, kompatibel mit Clients wie Qoder / Claude / Cursor

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

Bereitstellung auf dem ModelScope MCP-Platz (gehostete Bereitstellung)

Der MCP-Platz von ModelScope unterstützt die gehostete Bereitstellung dieses Servers als Cloud-MCP-Dienst mit einer exklusiven Remote-URL (SSE / Streamable HTTP) – Nutzer können sich remote verbinden, ohne lokal etwas auszuführen.

1. npm-Paket veröffentlichen (nur beim ersten Mal)

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

2. Dienst auf ModelScope erstellen

Gehen Sie zur Erstellungsseite (oder erstellen Sie schnell aus dem GitHub-Repository) und füllen Sie Folgendes aus:

Die Plattform-Bereitstellungsprüfung führt npx -y redfox-mcp-server@latest aus und ruft tools/list auf (getestet: 91 Tools werden ohne API-Key zurückgegeben, die Prüfung läuft problemlos durch).

3. Nutzung durch Anwender

Der Anwender trägt auf der Dienst-Detailseite seinen eigenen REDFOX_API_KEY ein → klickt auf „Verbinden" → erhält eine exklusive Remote-URL:

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

In einen beliebigen MCP-Client (Qoder / Dify / Tongyi Lingma usw.) eintragen und alle 91 Tools remote nutzen.

Einschränkungen der kostenlosen Bereitstellung: maximal 20 bereitgestellte Dienste pro Nutzer, 1 Instanz pro Dienst, ≤500 Anfragen innerhalb eines 5-Sekunden-Fensters für alle kostenlosen Dienste, ≤50000 Anfragen insgesamt pro Nutzer.

Related MCP server: rednote-analyzer-mcp

Schnellstart

1. API-Key abrufen

Rufen Sie RedFox Hub auf, um den REDFOX_API_KEY zu erhalten.

2. Server starten

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

3. Im Client konfigurieren

Qoder: Fügen Sie diesen Server in der MCP-Konfiguration hinzu (nach der Veröffentlichung per npx, bei lokaler Entwicklung per node):

• npx-Methode (empfohlen, erfordert veröffentlichtes npm-Paket):

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

• Lokale Entwicklungsmethode:

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

Die Qoder-Registrierungsdateien (SERVER_METADATA.json + tools/*.json) befinden sich unter qoder-register/ und werden automatisch von gen-qoder-register.js generiert.

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

Werkzeugliste

Architektur

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）

Datenfluss

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

Design der Tool-Parameter

• Parameternamen entsprechen den RedFox-API-Payload-Feldern (camelCase: startDate/pageNum/pageSize)

• Das Feld source wird vom Server automatisch auf RedFoxMCP gesetzt, kein Parameter vom Aufrufer erforderlich

• Asynchrone Aufgaben-Tools (Video-Generierung / Video-zu-Text / Kommentarabruf) senden automatisch und pollen, das Endergebnis wird direkt zurückgegeben

Werkzeugliste neu generieren

Nach Skript-Updates im Repository die API-Informationen neu extrahieren:

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 注册文件

Nicht angebundene Tools (24)

Die folgenden Skills haben keine API-Endpunkte (reine KI-Analyse/Prompt-Typen) und sind nicht als Tools registriert:

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 usw.

Zum Anbinden können die entsprechenden Endpunkte in src/overrides.js ergänzt und anschließend neu generiert werden.

Häufig gestellte Fragen

F: Tool-Aufruf gibt [NO_API_KEY] zurück? A: Die Umgebungsvariable REDFOX_API_KEY ist nicht gesetzt. Bitte vor dem Start konfigurieren.

F: Gibt [BIZ_ERROR] zurück? A: Der API-Key ist ungültig oder die Berechtigungen reichen nicht aus. Bitte prüfen Sie den Key-Status im RedFox Hub.

F: Wie testet man?

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