Asenkron bir REST API kullanarak herkese açık medya URL'lerinden video ve ses indirin veya meta verileri ayıklayın.
Ayrıca bilinen adı huntapi/huntapi-mcp, huntapi-mcp, @huntapi/mcp
- Yıldızlar
- 0
- Araçlar
- 7
- İndirmeler, 30 gün
- 327
- En son sürüm
- 0.1.0
- Son commit
- 11 Kas 2026
- Lisans
- MIT
HuntAPI MCP nedir?
HuntAPI bir MCP sunucusudur. Asenkron bir REST API kullanarak herkese açık medya URL'lerinden video ve ses indirin veya meta verileri ayıklayın. 7 araç sunar; örneğin audio_download, jobs, media_metadata.
Özet, projenin README dosyasından oluşturuldu
HuntAPI MCP sunucusu hakkında
HuntAPI, geliştiricilerin Model Context Protocol aracılığıyla bir medya indirme API'si ile etkileşime girmesini sağlar. Bu sunucu; Claude, Cursor, Windsurf ve VS Code gibi yapay zeka istemcilerinin herkese açık URL'lerden ses ve video indirme veya medya dosyalarından meta veri ayıklama gibi görevleri gerçekleştirmesine olanak tanır. Asenkron bir REST API olarak çalışır, yani kullanıcılar bir görevi başlatabilir ve daha sonra ilerlemesini kontrol edebilirler.
Kullanıcılar bu sunucuyu birden fazla şekilde dağıtabilirler. mcp.huntapi.com adresindeki barındırılan sürümü, header kısmında bir API anahtarı sağlayarak streamable HTTP üzerinden kullanabilir veya Node.js 20 veya üzeri ile stdio kullanarak yerel olarak çalıştırabilirsiniz. Yerel kurulumlar, ortam değişkenleri (environment variables) aracılığıyla iletilen bir HuntAPI API anahtarı gerektirir. Sunucu; audio_download, video_download, media_metadata ve durum kontrolü için jobs dahil olmak üzere bu görevleri yönetmek için özel araçlar içerir. Ayrıca, hesap kredilerini kontrol etmek için usage ve altyapı sağlığını izlemek için stats gibi yardımcı araçlar da sunar.
Neler yapabilirsiniz
- 1Medya bilgilerini ayıklayınYapay zekadan, dosyanın tamamını indirmeden belirli bir medya URL'sinden meta verileri getirmesini isteyin.
- 2Ses veya video dosyalarını indirinİstemciye, herkese açık bir bağlantıdan bir video veya ses dosyası için indirme işlemi başlatması talimatını verin.
- 3İndirme ilerlemesini izleyinYapay zekanın aktif bir medya görevinin mevcut durumunu ve tamamlanma yüzdesini kontrol etmesini sağlayın.
- 4Hesap kredi bakiyesini kontrol edinHuntAPI hesabınız için mevcut kullanım istatistiklerini ve kalan kredileri talep edin.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
HuntAPI MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıCursor'a ekleGoose'a ekleHuntAPI MCP'yi Claude Code içine yükleyin
$ claude mcp add --env 'HUNTAPI_API_KEY=<YOUR_HUNTAPI_API_KEY>' huntapi-mcp -- npx -y @huntapi/mcpHuntAPI MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"huntapi-mcp": {
"command": "npx",
"args": [
"-y",
"@huntapi/mcp"
],
"env": {
"HUNTAPI_API_KEY": "<YOUR_HUNTAPI_API_KEY>"
}
}
}
}HuntAPI MCP'yi VS Code içine yükleyin
.vscode/mcp.json
{
"servers": {
"huntapi-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@huntapi/mcp"
],
"env": {
"HUNTAPI_API_KEY": "<YOUR_HUNTAPI_API_KEY>"
}
}
}
}HuntAPI MCP'yi VS Code CLI içine yükleyin
$ code --add-mcp '{"name":"huntapi-mcp","type":"stdio","command":"npx","args":["-y","@huntapi/mcp"],"env":{"HUNTAPI_API_KEY":"<YOUR_HUNTAPI_API_KEY>"}}'HuntAPI MCP'yi Claude Desktop içine yükleyin
claude_desktop_config.json
{
"mcpServers": {
"huntapi-mcp": {
"command": "npx",
"args": [
"-y",
"@huntapi/mcp"
],
"env": {
"HUNTAPI_API_KEY": "<YOUR_HUNTAPI_API_KEY>"
}
}
}
}HuntAPI MCP'yi Codex içine yükleyin
$ codex mcp add huntapi-mcp --env 'HUNTAPI_API_KEY=<YOUR_HUNTAPI_API_KEY>' -- npx -y @huntapi/mcpHuntAPI MCP'yi Codex config.toml içine yükleyin
~/.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>"
HuntAPI MCP'yi Gemini CLI içine yükleyin
$ gemini mcp add -s user -e 'HUNTAPI_API_KEY=<YOUR_HUNTAPI_API_KEY>' huntapi-mcp npx -- -y @huntapi/mcpHuntAPI MCP'yi Gemini settings.json içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"huntapi-mcp": {
"command": "npx",
"args": [
"-y",
"@huntapi/mcp"
],
"env": {
"HUNTAPI_API_KEY": "<YOUR_HUNTAPI_API_KEY>"
}
}
}
}HuntAPI MCP araçları 7
README dosyasından algılandıaudio_downloadjobsmedia_metadatastatsusagevideo_downloadwait_for_job
| audio_download | — | |
| jobs | — | |
| media_metadata | — | |
| stats | — | |
| usage | — | |
| video_download | — | |
| wait_for_job | — |
Yapılandırma
HUNTAPI_API_KEYGerekliGizliHuntAPI API key.
| Ad | Açıklama | Sunucu |
|---|---|---|
| HUNTAPI_API_KEY | HuntAPI API key. | GerekliGizli |
Otomatik kontroller
Çalıştırıldı 12 Kas 2026Tam rapor →Otomatik kontrollerimizden geçti. Bu bir güvenlik denetimi değildir: kodu okuyun ve sunucuya ihtiyaç duyduğu en dar erişimi verin. Kontroller nasıl çalışır
- Kaynak deposu bağlantılı ve erişilebilirGeçti
- Açık kaynak lisansı (OSI)Geçti
- Son bir yıl içinde commit veya sürüm mevcutGeçti
- Paket adı popüler bir pakete yakın değilGeçti
- Uzak uç nokta HTTPS kullanıyorGeçti
- Yıkıcı araçlar etiketlenmişGeçti
- Modele yönelik gizli talimat yokGeçti
- Pakette veya bağımlılıklarında kritik uyarı yokGeçti
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 soruları
HuntAPI MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add --env 'HUNTAPI_API_KEY=<YOUR_HUNTAPI_API_KEY>' huntapi-mcp -- npx -y @huntapi/mcp komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
HuntAPI MCP'yi Cursor'a nasıl eklerim?
~/.cursor/mcp.json dosyasını açın ve yukarıdaki yükleme bölümünde gösterilen Cursor yapılandırmasını kullanarak sunucuyu mcpServers altına ekleyin.
HuntAPI MCP hangi araçları sunar?
7 araç sunar; bunlar arasında audio_download, jobs, media_metadata, stats, usage yer alır.
HuntAPI'yi Claude Desktop ile nasıl kullanırım?
Releases sayfasından .mcpb paketini indirip açabilir veya npx kullanarak sunucuyu yapılandırma dosyanıza ekleyebilirsiniz.
Dosyanın tamamını indirmeden meta verileri ayıklayabilir miyim?
Evet, media_metadata aracı, bir medya URL'sinden dosyayı indirmeden meta verileri ayıklamanıza olanak tanır.
Sunucuyu çalıştırmak için gereksinimler nelerdir?
Node.js sürüm 20 veya üzeri ile geçerli bir HuntAPI API anahtarına ihtiyacınız vardır.
Araçları kullanmak bir maliyet gerektiriyor mu?
Evet, API'yi çağıran her araç kredi tüketir.