中文 English

redfox-mcp

RedFoxHub MCP Server — turns the data APIs of 6 major content platforms plus AI search / generation capabilities into 40 MCP tools, ready for any MCP client such as dsh, Claude Code or Cursor.

Tools (40)

Async tools (AI search / generation) poll internally: submit → wait → return the full result, with no manual taskId handling. If the wait exceeds timeout_seconds (default 240s, 480s for video), a taskId is returned for the matching result tool.

Authentication

All APIs require a RedFoxHub API key:

1. Get one at https://redfox.hk/settings/api-keys/?source=mcp
2. Set the environment variable:

export REDFOX_API_KEY="YOUR_API_KEY"

Without a key, every tool returns a structured message explaining how to obtain one.

Install & Run

Python ≥ 3.10 required. Recommended via uv:

uvx redfox-mcp

or:

pip install redfox-mcp
redfox-mcp

The server runs on stdio transport.

Client Configuration

dsh (DeepSeek Harness)

Install the official bundle plugin redfox-community-dsh — it registers this MCP server out of the box, exposing tools as mcp__redfox__*:

dsh plugin --profile web add -w github:redfox-data/redfox-community-dsh

Claude Code

claude mcp add redfox --env REDFOX_API_KEY=YOUR_API_KEY -- uvx redfox-mcp

Cursor / other MCP clients

Add to your MCP configuration:

{
  "mcpServers": {
    "redfox": {
      "command": "uvx",
      "args": ["redfox-mcp"],
      "env": { "REDFOX_API_KEY": "YOUR_API_KEY" }
    }
  }
}

Remote HTTP Mode (multi-tenant)

For MCP marketplaces and hosted scenarios, the server can also run as a remote HTTP service where every user brings their own API key:

redfox-mcp --transport http --host 0.0.0.0 --port 8000
# or via env vars: REDFOX_MCP_TRANSPORT=http REDFOX_MCP_HOST=0.0.0.0 REDFOX_MCP_PORT=8000

• MCP endpoint: http://<host>:8000/mcp (Streamable HTTP); health check: GET /health
• Each request carries its own key via header X-API-Key: <key> (or Authorization: Bearer <key>). A dedicated client is created and cached per key — quotas are never shared across users. Missing key returns a structured guide instead of an exception.
• Client-side config (remote URL + header):

{
  "mcpServers": {
    "redfox": {
      "url": "http://<host>:8000/mcp",
      "headers": { "X-API-Key": "ak_your_key" }
    }
  }
}

Local stdio mode remains the default and is fully backward-compatible.

Under the Hood

Built on the official SDK redfox-python-sdk. API docs: https://redfox.hk/?source=mcp.

License

MIT