Download video dan audio dari URL media publik atau ekstrak metadata menggunakan REST API asinkron.
Juga dikenal sebagai huntapi/huntapi-mcp, huntapi-mcp, @huntapi/mcp
- Stars
- 0
- Tools
- 7
- Unduhan, 30 hari
- 327
- Versi terbaru
- 0.1.0
- Commit terakhir
- 11 Nov 2026
- Lisensi
- MIT
Apa itu HuntAPI MCP?
HuntAPI adalah MCP server. Download video dan audio dari URL media publik atau ekstrak metadata menggunakan REST API asinkron. Server ini menyediakan 7 tool, seperti audio_download, jobs, media_metadata.
Ringkasan dibuat dari README proyek
Tentang HuntAPI MCP server
HuntAPI menyediakan cara bagi developer untuk berinteraksi dengan API download media melalui Model Context Protocol. Server ini memungkinkan AI client seperti Claude, Cursor, Windsurf, dan VS Code untuk melakukan tugas seperti mengunduh audio dan video dari URL publik atau mengekstrak metadata dari file media. Server ini berfungsi sebagai REST API asinkron, yang berarti pengguna dapat memulai sebuah tugas dan kemudian memeriksa progresnya di lain waktu.
Pengguna dapat men-deploy server ini dengan berbagai cara. Anda bisa menggunakan versi hosted di mcp.huntapi.com via streamable HTTP dengan menyertakan API key di bagian header, atau menjalankannya secara lokal menggunakan stdio dengan Node.js 20 atau yang lebih baru. Setup lokal memerlukan API key HuntAPI yang dikirimkan melalui environment variables. Server ini menyertakan tool khusus untuk mengelola tugas-tugas tersebut, termasuk audio_download, video_download, media_metadata, serta jobs untuk memantau status. Server ini juga menawarkan utility tool seperti usage untuk mengecek kredit akun dan stats untuk memantau kesehatan infrastruktur.
Apa yang bisa Anda lakukan dengannya
- 1Ekstrak informasi mediaMinta AI untuk mengambil metadata dari URL media tertentu tanpa perlu mengunduh seluruh filenya.
- 2Download file audio atau videoInstruksikan client untuk memulai proses download file video atau audio dari link publik.
- 3Pantau progres downloadMinta AI untuk mengecek status saat ini dan persentase penyelesaian dari sebuah job media yang sedang berjalan.
- 4Cek saldo kredit akunMinta statistik penggunaan saat ini dan sisa kredit untuk akun HuntAPI Anda.
Ditulis berdasarkan README proyek. Setiap use case diperiksa terhadap kutipan dari README tersebut.
Cara menginstal HuntAPI MCP
Format diverifikasi 10 Nov 2026Tambahkan ke CursorTambahkan ke GooseInstal HuntAPI MCP di Claude Code
$ claude mcp add --env 'HUNTAPI_API_KEY=<YOUR_HUNTAPI_API_KEY>' huntapi-mcp -- npx -y @huntapi/mcpInstal HuntAPI MCP di Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"huntapi-mcp": {
"command": "npx",
"args": [
"-y",
"@huntapi/mcp"
],
"env": {
"HUNTAPI_API_KEY": "<YOUR_HUNTAPI_API_KEY>"
}
}
}
}Instal HuntAPI MCP di VS Code
.vscode/mcp.json
{
"servers": {
"huntapi-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@huntapi/mcp"
],
"env": {
"HUNTAPI_API_KEY": "<YOUR_HUNTAPI_API_KEY>"
}
}
}
}Instal HuntAPI MCP di VS Code CLI
$ code --add-mcp '{"name":"huntapi-mcp","type":"stdio","command":"npx","args":["-y","@huntapi/mcp"],"env":{"HUNTAPI_API_KEY":"<YOUR_HUNTAPI_API_KEY>"}}'Instal HuntAPI MCP di Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"huntapi-mcp": {
"command": "npx",
"args": [
"-y",
"@huntapi/mcp"
],
"env": {
"HUNTAPI_API_KEY": "<YOUR_HUNTAPI_API_KEY>"
}
}
}
}Instal HuntAPI MCP di Codex
$ codex mcp add huntapi-mcp --env 'HUNTAPI_API_KEY=<YOUR_HUNTAPI_API_KEY>' -- npx -y @huntapi/mcpInstal HuntAPI MCP di Codex config.toml
~/.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>"
Instal HuntAPI MCP di Gemini CLI
$ gemini mcp add -s user -e 'HUNTAPI_API_KEY=<YOUR_HUNTAPI_API_KEY>' huntapi-mcp npx -- -y @huntapi/mcpInstal HuntAPI MCP di Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"huntapi-mcp": {
"command": "npx",
"args": [
"-y",
"@huntapi/mcp"
],
"env": {
"HUNTAPI_API_KEY": "<YOUR_HUNTAPI_API_KEY>"
}
}
}
}Tool HuntAPI MCP 7
Terdeteksi dari READMEaudio_downloadjobsmedia_metadatastatsusagevideo_downloadwait_for_job
| audio_download | — | |
| jobs | — | |
| media_metadata | — | |
| stats | — | |
| usage | — | |
| video_download | — | |
| wait_for_job | — |
Konfigurasi
HUNTAPI_API_KEYWajibRahasiaHuntAPI API key.
| Nama | Deskripsi | Tipe |
|---|---|---|
| HUNTAPI_API_KEY | HuntAPI API key. | WajibRahasia |
Pengecekan otomatis
Berjalan 12 Nov 2026Laporan lengkap →Lolos checks otomatis kami. Ini bukan audit keamanan: baca kodenya dan berikan server akses paling terbatas yang dibutuhkannya. Cara kerja checks
- Source repository terhubung dan dapat dijangkauLolos
- Lisensi open source (OSI)Lolos
- Ada commit atau release dalam satu tahun terakhirLolos
- Nama package tidak mirip dengan package populerLolos
- Remote endpoint menggunakan HTTPSLolos
- Tools yang bersifat destruktif telah diberi labelLolos
- Tidak ada instruksi tersembunyi untuk modelLolos
- Tidak ada advisory kritis pada paket atau dependensinyaLolos
README
Lihat di GitHubHuntAPI 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.
Pertanyaan tentang HuntAPI MCP
Bagaimana cara menambahkan HuntAPI MCP ke Claude Code?
Jalankan claude mcp add --env 'HUNTAPI_API_KEY=<YOUR_HUNTAPI_API_KEY>' huntapi-mcp -- npx -y @huntapi/mcp di terminal Anda. Tambahkan --scope user agar tersedia di semua proyek.
Bagaimana cara menambahkan HuntAPI MCP ke Cursor?
Buka ~/.cursor/mcp.json dan tambahkan server di bawah mcpServers, menggunakan config Cursor yang ditunjukkan di bagian instalasi di atas.
Tool apa yang disediakan HuntAPI MCP?
Server ini menyediakan 7 tool, termasuk audio_download, jobs, media_metadata, stats, usage.
Bagaimana cara menggunakan HuntAPI dengan Claude Desktop?
Anda dapat mengunduh bundle .mcpb dari halaman releases dan membukanya, atau menambahkan server ke file konfigurasi Anda menggunakan npx.
Bisakah saya mengekstrak metadata tanpa mengunduh seluruh file?
Ya, tool media_metadata memungkinkan Anda mengekstrak metadata dari URL media tanpa harus mengunduh filenya.
Apa saja persyaratan untuk menjalankan server ini?
Anda memerlukan Node.js versi 20 atau yang lebih baru serta API key HuntAPI yang valid.
Apakah menggunakan tool ini berbayar?
Ya, setiap tool yang memanggil API akan mengonsumsi kredit.