비동기 REST API를 사용하여 공개 미디어 URL에서 비디오와 오디오를 다운로드하거나 메타데이터를 추출합니다.
다른 이름 huntapi/huntapi-mcp, huntapi-mcp, @huntapi/mcp
- 스타
- 0
- Tools
- 7
- 다운로드, 30일
- 327
- 최신 버전
- 0.1.0
- 마지막 커밋
- 2026년 11월 11일
- 라이선스
- MIT
HuntAPI MCP란?
HuntAPI은(는) MCP server입니다. 비동기 REST API를 사용하여 공개 미디어 URL에서 비디오와 오디오를 다운로드하거나 메타데이터를 추출합니다. 7개 도구를 제공합니다. 예: audio_download, jobs, media_metadata.
프로젝트 README에서 생성된 요약
HuntAPI MCP server 정보
HuntAPI는 개발자가 Model Context Protocol을 통해 미디어 다운로드 API와 상호작용할 수 있는 방법을 제공합니다. 이 MCP server를 사용하면 Claude, Cursor, Windsurf, VS Code와 같은 AI 클라이언트가 공개 URL에서 오디오 및 비디오를 다운로드하거나 미디어 파일에서 메타데이터를 추출하는 등의 작업을 수행할 수 있습니다. 비동기 REST API 방식으로 작동하므로 사용자는 작업을 시작한 후 나중에 진행 상황을 확인할 수 있습니다.
사용자는 다양한 방식으로 이 서버를 배포할 수 있습니다. 헤더에 API key를 제공하여 mcp.huntapi.com에서 streamable HTTP를 통해 호스팅 버전을 사용하거나, Node.js 20 이상 환경에서 stdio를 사용하여 로컬에서 실행할 수 있습니다. 로컬 설정 시에는 환경 변수를 통해 HuntAPI API key를 전달해야 합니다. 서버에는 audio_download, video_download, media_metadata 및 상태 확인을 위한 jobs 등 이러한 작업을 관리하기 위한 특정 도구가 포함되어 있습니다. 또한 계정 크레딧을 확인하는 usage나 인프라 상태를 모니터링하는 stats와 같은 유틸리티 도구도 제공합니다.
활용 사례
- 1미디어 정보 추출파일 전체를 다운로드하지 않고 특정 미디어 URL에서 메타데이터를 가져오도록 AI에게 요청합니다.
- 2오디오 또는 비디오 파일 다운로드공개 링크에 있는 비디오 또는 오디오 파일의 다운로드 프로세스를 시작하도록 클라이언트에 지시합니다.
- 3다운로드 진행 상황 모니터링AI가 현재 실행 중인 미디어 작업의 상태와 완료 백분율을 확인하도록 합니다.
- 4계정 크레딧 잔액 확인HuntAPI 계정의 현재 사용 통계와 남은 크레딧을 요청합니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
HuntAPI MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 HuntAPI MCP 설치
$ claude mcp add --env 'HUNTAPI_API_KEY=<YOUR_HUNTAPI_API_KEY>' huntapi-mcp -- npx -y @huntapi/mcpCursor에 HuntAPI MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"huntapi-mcp": {
"command": "npx",
"args": [
"-y",
"@huntapi/mcp"
],
"env": {
"HUNTAPI_API_KEY": "<YOUR_HUNTAPI_API_KEY>"
}
}
}
}VS Code에 HuntAPI MCP 설치
.vscode/mcp.json
{
"servers": {
"huntapi-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@huntapi/mcp"
],
"env": {
"HUNTAPI_API_KEY": "<YOUR_HUNTAPI_API_KEY>"
}
}
}
}VS Code CLI에 HuntAPI MCP 설치
$ code --add-mcp '{"name":"huntapi-mcp","type":"stdio","command":"npx","args":["-y","@huntapi/mcp"],"env":{"HUNTAPI_API_KEY":"<YOUR_HUNTAPI_API_KEY>"}}'Claude Desktop에 HuntAPI MCP 설치
claude_desktop_config.json
{
"mcpServers": {
"huntapi-mcp": {
"command": "npx",
"args": [
"-y",
"@huntapi/mcp"
],
"env": {
"HUNTAPI_API_KEY": "<YOUR_HUNTAPI_API_KEY>"
}
}
}
}Codex에 HuntAPI MCP 설치
$ codex mcp add huntapi-mcp --env 'HUNTAPI_API_KEY=<YOUR_HUNTAPI_API_KEY>' -- npx -y @huntapi/mcpCodex config.toml에 HuntAPI MCP 설치
~/.codex/config.toml
[mcp_servers.huntapi-mcp] command = "npx" args = ["-y", "@huntapi/mcp"] [mcp_servers.huntapi-mcp.env] HUNTAPI_API_KEY = "<YOUR_HUNTAPI_API_KEY>"
Gemini CLI에 HuntAPI MCP 설치
$ gemini mcp add -s user -e 'HUNTAPI_API_KEY=<YOUR_HUNTAPI_API_KEY>' huntapi-mcp npx -- -y @huntapi/mcpGemini settings.json에 HuntAPI MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"huntapi-mcp": {
"command": "npx",
"args": [
"-y",
"@huntapi/mcp"
],
"env": {
"HUNTAPI_API_KEY": "<YOUR_HUNTAPI_API_KEY>"
}
}
}
}HuntAPI MCP 도구 7
README에서 감지됨audio_downloadjobsmedia_metadatastatsusagevideo_downloadwait_for_job
| audio_download | — | |
| jobs | — | |
| media_metadata | — | |
| stats | — | |
| usage | — | |
| video_download | — | |
| wait_for_job | — |
구성
HUNTAPI_API_KEY필수비밀HuntAPI API key.
| 이름 | 설명 | 유형 |
|---|---|---|
| HUNTAPI_API_KEY | HuntAPI API key. | 필수비밀 |
자동 검사
2026년 11월 12일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 이는 보안 감사가 아닙니다. 코드를 직접 읽고 서버에 필요한 최소한의 권한만 부여하십시오. 검사 방식
- 소스 저장소 연결 및 접근 가능통과
- 오픈 소스 라이선스 (OSI)통과
- 최근 1년 내 커밋 또는 릴리스통과
- 패키지 이름이 인기 패키지와 유사하지 않음통과
- 원격 엔드포인트가 HTTPS 사용통과
- 파괴적인 도구에 라벨 표시됨통과
- 모델에 대한 숨겨진 지침 없음통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음통과
README
GitHub에서 보기HuntAPI MCP Server
Official Model Context Protocol server for the HuntAPI media download API.
Download video and audio from public media URLs, or extract their metadata, with one async REST API.
It lets Claude, Cursor, VS Code, Windsurf and any MCP client call the API as tools. Runs over stdio (local) or Streamable HTTP (self-hosted).
Requirements
Hosted server (recommended)
HuntAPI runs this server for you at https://mcp.huntapi.com/ (Streamable HTTP). Send your API key in the x-api-key header; nothing to install.
claude mcp add --transport http huntapi https://mcp.huntapi.com/ --header "x-api-key: YOUR_API_KEY"
{
"mcpServers": {
"huntapi": {
"url": "https://mcp.huntapi.com/",
"headers": {
"x-api-key": "YOUR_API_KEY"
}
}
}
}
The hosted server and this package expose the same API; run the package locally when you want stdio, your own network egress, or to self-host it.
Run it locally
Claude Code
claude mcp add huntapi --env HUNTAPI_API_KEY=YOUR_API_KEY -- npx -y @huntapi/mcp
Claude Desktop, Cursor, Windsurf and other clients
Add the server to the client's MCP configuration (claude_desktop_config.json, .cursor/mcp.json…):
{
"mcpServers": {
"huntapi": {
"command": "npx",
"args": ["-y", "@huntapi/mcp"],
"env": {
"HUNTAPI_API_KEY": "YOUR_API_KEY"
}
}
}
}
VS Code
{
"servers": {
"huntapi": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@huntapi/mcp"],
"env": {
"HUNTAPI_API_KEY": "${input:huntapi-api-key}"
}
}
},
"inputs": [
{
"type": "promptString",
"id": "huntapi-api-key",
"description": "HuntAPI API key",
"password": true
}
]
}
Claude Desktop extension
Download the .mcpb bundle from the releases page and open it; Claude Desktop asks for your API key.
Docker
docker build -t huntapi-mcp .
docker run -i --rm -e HUNTAPI_API_KEY=YOUR_API_KEY huntapi-mcp
Tools
| Tool | Description |
|---|---|
audio_download |
Download audio from a URL via HuntAPI and receive a job id. |
jobs |
Poll status, progress (0–100), and result of an async HuntAPI job. |
media_metadata |
Extract metadata from a media URL without downloading the file. |
stats |
Infrastructure health for an engine or endpoint over the last hour. Not scoped to your account or tenant. Enabled per account: HTTP 403 means contact support to activate it. |
usage |
Retrieve real-time usage statistics and credit balance for your Huntapi account. |
video_download |
Video Download |
wait_for_job |
Wait for an async download job to finish. |
Every tool that calls the API consumes credits. JSON results are returned as text; images are returned inline and other files (PDF…) as embedded resources, up to 4 MB.
Streamable HTTP
npx @huntapi/mcp --http --port 3000
The endpoint is POST /mcp (stateless, JSON responses). Each client sends its own key in the x-api-key header (or Authorization: Bearer <key>); the server never uses a key of its own. It binds to 127.0.0.1 by default and rejects browser origins unless you allow them — put it behind TLS before exposing it.
createHttpHandler() is exported for Fetch-compatible runtimes (Cloudflare Workers, Deno, Bun):
import { createHttpHandler } from "@huntapi/mcp";
export default { fetch: createHttpHandler({ allowedOrigins: [] }) };
Security
- The API key is read from
HUNTAPI_API_KEY(stdio) or the request headers (HTTP) and removed from error messages. - Content fetched from websites is untrusted: the server instructions tell the model to treat it as data, not instructions.
- See SECURITY.md to report a vulnerability.
Development
npm install
npm test
npm run build
npx @modelcontextprotocol/inspector node dist/stdio.js
Built on the SDK
The server uses the official Node.js SDK (@huntapi/sdk).
All HuntAPI SDKs
| SDK | Package | Install |
|---|---|---|
| Node.js | @huntapi/sdk |
npm install @huntapi/sdk |
| Python | huntapi |
pip install huntapi |
| Go | huntapi-go |
go get github.com/huntapi/huntapi-go |
| .NET | HuntApi |
dotnet add package HuntApi |
| Ruby | huntapi |
gem install huntapi |
| PHP | huntapi/sdk |
composer require huntapi/sdk |
| Java | huntapi-java |
build from source, see its README |
| CLI | @huntapi/cli |
npm install -g @huntapi/cli |
| MCP server | @huntapi/mcp |
npx -y @huntapi/mcp |
License
MIT — see LICENSE.
HuntAPI MCP 질문
HuntAPI MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add --env 'HUNTAPI_API_KEY=<YOUR_HUNTAPI_API_KEY>' huntapi-mcp -- npx -y @huntapi/mcp를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
HuntAPI MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
HuntAPI MCP는 어떤 도구를 제공하나요?
7개 도구를 제공합니다. 예: audio_download, jobs, media_metadata, stats, usage.
Claude Desktop에서 HuntAPI를 어떻게 사용하나요?
releases 페이지에서 .mcpb 번들을 다운로드하여 열거나, npx를 사용하여 설정 파일에 MCP server를 추가할 수 있습니다.
파일 전체를 다운로드하지 않고 메타데이터만 추출할 수 있나요?
네, media_metadata 도구를 사용하면 파일을 다운로드하지 않고도 미디어 URL에서 메타데이터를 추출할 수 있습니다.
서버 실행을 위한 요구 사항은 무엇인가요?
Node.js 버전 20 이상과 유효한 HuntAPI API key가 필요합니다.
도구 사용 시 비용이 발생하나요?
네, API를 호출하는 모든 도구는 크레딧을 소모합니다.