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 패키지 게시 (최초 1회만)

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 文件读）