中文 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
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" }
    }
  }
}

Under the Hood

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

License

MIT