RedFox MCP Server

Wraps the 115 Agent Skills from the redfox-community repository into a single MCP server (Option 2: all tools available in one deployment).

• 91 tools directly callable (integrated with the real RedFox API)

• Zero dependencies: pure native Node.js implementation (built-in fetch), no npm install, no Python required

• Protocol: MCP (Model Context Protocol) over stdio, compatible with Qoder / Claude / Cursor and other clients

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

Deploy to ModelScope MCP Plaza (Hosted Deployment)

ModelScope MCP Plaza supports hosted deployment of this server as a cloud MCP service, providing a dedicated Remote URL (SSE / Streamable HTTP) externally, so users can connect remotely without running it locally.

1. Publish the npm package (first time only)

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

2. Create the service on ModelScope

Go to the creation page (or quickly create from a GitHub repository) and fill in:

The platform deployment check runs npx -y redfox-mcp-server@latest and calls tools/list (it has been verified that 91 tools are returned without an API Key, so the check passes smoothly).

3. User usage

On the service details page, users fill in their own REDFOX_API_KEY → click "Connect" → get a dedicated Remote URL:

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

Paste it into any MCP client (Qoder / Dify / Tongyi Lingma, etc.) to remotely use all 91 tools.

Free deployment limits: up to 20 deployed services per user, 1 instance per service, ≤500 requests per 5-second window across all free services, and ≤50,000 requests total per user.

Related MCP server: rednote-analyzer-mcp

Quick Start

1. Get an API Key

Go to RedFox Hub to get your REDFOX_API_KEY.

2. Start the server

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

3. Configure in a client

Qoder: Add this server in the MCP configuration (use the npx method after publishing, or the node method for local development):

• npx method (recommended, requires the npm package to be published):

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

• Local development method:

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

The Qoder registration files (SERVER_METADATA.json + tools/*.json) are located in qoder-register/ and are automatically generated by gen-qoder-register.js.

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

Tool List

Architecture

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）

Data Flow

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

Tool Parameter Design

• Parameter names match the RedFox API payload fields (camelCase: startDate/pageNum/pageSize)

• The source field is automatically filled in by the server as RedFoxMCP; callers do not need to pass it

• Asynchronous task tools (video generation / video-to-copy / comment retrieval) automatically submit + poll and return the final result directly

Regenerate the Tool List

After updating the repository scripts, re-extract the API information:

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

Tools Not Integrated (24)

The following Skills have no API endpoints (pure AI analysis / prompt-based) and are not registered as tools:

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.

To integrate them, add the corresponding endpoints in src/overrides.js and regenerate.

FAQ

Q: Tool calls return [NO_API_KEY]? A: The REDFOX_API_KEY environment variable is not set. Please configure it before starting.

Q: Returns [BIZ_ERROR]? A: The API Key is invalid or has insufficient permissions. Check the Key status on RedFox Hub.

Q: How to test?

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