RedFox MCP Server

Оборачивает 115 Agent Skill из репозитория redfox-community в единый MCP-сервер (вариант 2: все инструменты доступны после одного развертывания).

• 91 инструмент доступен для прямого вызова (подключены к реальному API RedFox)

• Ноль зависимостей: чистая реализация на Node.js (встроенный fetch), без npm install, без Python

• Протокол: MCP (Model Context Protocol) через stdio, совместим с клиентами Qoder / Claude / Cursor и др.

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

Развертывание на ModelScope MCP Plaza (управляемое развертывание)

ModelScope MCP Plaza поддерживает управляемое развертывание этого сервера как облачного MCP-сервиса с выделенным Remote URL (SSE / Streamable HTTP), позволяя пользователям подключаться удаленно без локального запуска.

1. Публикация npm-пакета (только первый раз)

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

2. Создание сервиса в ModelScope

Перейдите на страницу создания (или создайте быстро из GitHub-репозитория) и заполните:

Проверка развертывания платформы выполнит npx -y redfox-mcp-server@latest и вызовет tools/list (проверено: возвращает 91 инструмент без API Key, проверка проходит успешно).

3. Использование пользователем

Пользователь вводит свой REDFOX_API_KEY на странице сведений о сервисе → нажимает «Подключить» → получает выделенный Remote URL:

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

Вставьте его в любой MCP-клиент (Qoder / Dify / Tongyi Lingma и др.), чтобы удаленно использовать все 91 инструмент.

Ограничения бесплатного развертывания: не более 20 развернутых сервисов на пользователя, 1 экземпляр на сервис, ≤500 запросов в 5-секундном окне для всех бесплатных сервисов, ≤50000 запросов суммарно на пользователя.

Related MCP server: rednote-analyzer-mcp

Быстрый старт

1. Получение API Key

Перейдите в RedFox hub, чтобы получить REDFOX_API_KEY.

2. Запуск сервера

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

3. Настройка в клиенте

Qoder: добавьте этот сервер в конфигурацию MCP (после публикации можно через npx, для локальной разработки — через node):

• Способ через npx (рекомендуется, требуется опубликованный npm-пакет):

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

• Способ локальной разработки:

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

Файлы регистрации Qoder (SERVER_METADATA.json + tools/*.json) находятся в qoder-register/ и автоматически генерируются скриптом gen-qoder-register.js.

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

Список инструментов

Архитектура

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）

Поток данных

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

Проектирование параметров инструментов

• Имена параметров совпадают с полями payload API RedFox (camelCase: startDate/pageNum/pageSize)

• Поле source автоматически заполняется сервером как RedFoxMCP, вызывающей стороне передавать его не нужно

• Инструменты с асинхронными задачами (генерация видео/извлечение текста из видео/получение комментариев) автоматически отправляют запрос + опрашивают и возвращают конечный результат

Перегенерация списка инструментов

После обновления скриптов репозитория заново извлеките информацию об 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 注册文件

Неподключенные инструменты (24)

Следующие Skill не имеют API-эндпоинтов (чисто AI-анализ/промпты) и не зарегистрированы как инструменты:

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 и др.

Для подключения добавьте соответствующие эндпоинты в src/overrides.js и перегенерируйте.

Часто задаваемые вопросы

В: Вызов инструмента возвращает [NO_API_KEY]? О: Не задана переменная окружения REDFOX_API_KEY, настройте её перед запуском.

В: Возвращается [BIZ_ERROR]? О: API Key недействителен или недостаточно прав, проверьте статус ключа в RedFox hub.

В: Как протестировать?

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