RedFox MCP Server

redfox-community リポジトリの 115 個の Agent Skill を 単一の MCP サーバー にカプセル化します（案2：すべてのツールを一度にデプロイして使用可能）。

• 91 個のツールを直接呼び出し可能（RedFox 実 API に接続済み）

• ゼロ依存：純粋な Node.js ネイティブ実装（組み込み fetch）、npm install 不要、Python 不要

• プロトコル：MCP (Model Context Protocol) over 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 広場へのデプロイ（ホスト型デプロイ）

魔搭 MCP 広場は、本サーバーをホスト型デプロイでクラウド MCP サービスとして提供し、専用の Remote URL（SSE / Streamable HTTP）を外部に公開します。ユーザーはローカルで実行することなくリモート接続できます。

1. npm パッケージの公開（初回のみ）

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

2. 魔搭でサービスを作成

作成ページ（または GitHub リポジトリからクイック作成）に移動し、以下を入力します：

プラットフォームのデプロイ検出は npx -y redfox-mcp-server@latest を実行し、tools/list を呼び出します（API Key なしで 91 個のツールが返ることを実測済みで、検出は問題なく通過します）。

3. ユーザーの利用

ユーザーはサービス詳細ページで自分の REDFOX_API_KEY を入力 → 「接続」をクリック → 専用の Remote URL を取得します：

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

任意の MCP クライアント（Qoder / Dify / 通義霊碼 など）に入力すると、リモートで全 91 個のツールを使用できます。

無料デプロイの制限：ユーザーごとに最大 20 個のデプロイサービス、各サービス 1 インスタンス、全無料サービスで 5 秒間のウィンドウ内 ≤500 リクエスト、単一ユーザーの合計 ≤50000 回。

Related MCP server: rednote-analyzer-mcp

クイックスタート

1. API Key の取得

红狐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/...

ツールパラメータ設計

• パラメータ名は RedFox API の payload フィールドと一致（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 に対応するエンドポイントを追加して再生成できます。

よくある質問

Q: ツール呼び出しで [NO_API_KEY] が返る？ A: REDFOX_API_KEY 環境変数が設定されていません。起動前に設定してください。

Q: [BIZ_ERROR] が返る？ A: API Key が無効または権限が不足しています。红狐hub で Key の状態を確認してください。

Q: テスト方法は？

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