Lade Videos und Audio von öffentlichen Medien-URLs herunter oder extrahiere Metadaten über eine asynchrone REST API.
Auch bekannt als huntapi/huntapi-mcp, huntapi-mcp, @huntapi/mcp
- Stars
- 0
- Tools
- 7
- Downloads, 30 Tage
- 327
- Neueste Version
- 0.1.0
- Letzter Commit
- 11. Nov. 2026
- Lizenz
- MIT
Was ist HuntAPI MCP?
HuntAPI ist ein MCP server. Lade Videos und Audio von öffentlichen Medien-URLs herunter oder extrahiere Metadaten über eine asynchrone REST API. Er stellt 7 Tools bereit, etwa audio_download, jobs, media_metadata.
Zusammenfassung generiert aus dem README des Projekts
Über HuntAPI MCP server
HuntAPI bietet Entwicklern eine Möglichkeit, über das Model Context Protocol mit einer Medien-Download-API zu interagieren. Dieser Server erlaubt es KI-Clients wie Claude, Cursor, Windsurf und VS Code, Aufgaben wie das Herunterladen von Audio und Video von öffentlichen URLs oder das Extrahieren von Metadaten aus Mediendateien auszuführen. Er funktioniert als asynchrone REST API, was bedeutet, dass Nutzer eine Aufgabe starten und den Fortschritt später überprüfen können.
Nutzer können diesen Server auf verschiedene Arten bereitstellen. Du kannst die gehostete Version unter mcp.huntapi.com via streamable HTTP nutzen, indem du einen API key im Header bereitstellst, oder du lässt ihn lokal via stdio mit Node.js 20 oder neuer laufen. Lokale Setups erfordern einen HuntAPI API key, der über Umgebungsvariablen übergeben wird. Der Server enthält spezifische Tools zur Verwaltung dieser Aufgaben, darunter audio_download, video_download, media_metadata sowie Jobs zum Polling des Status. Zudem bietet er Utility-Tools wie usage, um Account-Credits zu prüfen, und stats, um den Zustand der Infrastruktur zu überwachen.
Was du damit machen kannst
- 1Medieninformationen extrahierenLass die KI Metadaten von einer spezifischen Medien-URL abrufen, ohne die gesamte Datei herunterzuladen.
- 2Audio- oder Videodateien herunterladenGib dem Client den Befehl, einen Download-Prozess für eine Video- oder Audiodatei von einem öffentlichen Link zu starten.
- 3Download-Fortschritt überwachenLass die KI den aktuellen Status und den prozentualen Fortschritt eines aktiven Medien-Jobs prüfen.
- 4Account-Guthaben prüfenFrage die aktuellen Nutzungsstatistiken und die verbleibenden Credits für deinen HuntAPI Account ab.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
So installierst du HuntAPI MCP
Formate geprüft am 10. Nov. 2026Zu Cursor hinzufügenZu Goose hinzufügenHuntAPI MCP in Claude Code installieren
$ claude mcp add --env 'HUNTAPI_API_KEY=<YOUR_HUNTAPI_API_KEY>' huntapi-mcp -- npx -y @huntapi/mcpHuntAPI MCP in Cursor installieren
~/.cursor/mcp.json
{
"mcpServers": {
"huntapi-mcp": {
"command": "npx",
"args": [
"-y",
"@huntapi/mcp"
],
"env": {
"HUNTAPI_API_KEY": "<YOUR_HUNTAPI_API_KEY>"
}
}
}
}HuntAPI MCP in VS Code installieren
.vscode/mcp.json
{
"servers": {
"huntapi-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@huntapi/mcp"
],
"env": {
"HUNTAPI_API_KEY": "<YOUR_HUNTAPI_API_KEY>"
}
}
}
}HuntAPI MCP in VS Code CLI installieren
$ code --add-mcp '{"name":"huntapi-mcp","type":"stdio","command":"npx","args":["-y","@huntapi/mcp"],"env":{"HUNTAPI_API_KEY":"<YOUR_HUNTAPI_API_KEY>"}}'HuntAPI MCP in Claude Desktop installieren
claude_desktop_config.json
{
"mcpServers": {
"huntapi-mcp": {
"command": "npx",
"args": [
"-y",
"@huntapi/mcp"
],
"env": {
"HUNTAPI_API_KEY": "<YOUR_HUNTAPI_API_KEY>"
}
}
}
}HuntAPI MCP in Codex installieren
$ codex mcp add huntapi-mcp --env 'HUNTAPI_API_KEY=<YOUR_HUNTAPI_API_KEY>' -- npx -y @huntapi/mcpHuntAPI MCP in Codex config.toml installieren
~/.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 in Gemini CLI installieren
$ gemini mcp add -s user -e 'HUNTAPI_API_KEY=<YOUR_HUNTAPI_API_KEY>' huntapi-mcp npx -- -y @huntapi/mcpHuntAPI MCP in Gemini settings.json installieren
~/.gemini/settings.json
{
"mcpServers": {
"huntapi-mcp": {
"command": "npx",
"args": [
"-y",
"@huntapi/mcp"
],
"env": {
"HUNTAPI_API_KEY": "<YOUR_HUNTAPI_API_KEY>"
}
}
}
}HuntAPI MCP tools 7
Erkannt aus dem READMEaudio_downloadjobsmedia_metadatastatsusagevideo_downloadwait_for_job
| audio_download | — | |
| jobs | — | |
| media_metadata | — | |
| stats | — | |
| usage | — | |
| video_download | — | |
| wait_for_job | — |
Konfiguration
HUNTAPI_API_KEYErforderlichSecretHuntAPI API key.
| Name | Beschreibung | Typ |
|---|---|---|
| HUNTAPI_API_KEY | HuntAPI API key. | ErforderlichSecret |
Automatisierte Checks
Geluften am 12. Nov. 2026Vollständiger Bericht →Unsere automatisierten Checks bestanden. Das ist kein Security-Audit: Lies den Code und gib dem Server nur den minimal notwendigen Zugriff. Wie die Checks funktionieren
- Source Repository verknüpft und erreichbarBestanden
- Open Source Lizenz (OSI)Bestanden
- Commit oder Release im letzten JahrBestanden
- Package-Name ähnelt keinem populären PackageBestanden
- Remote Endpoint nutzt HTTPSBestanden
- Destruktive Tools sind markiertBestanden
- Keine versteckten Anweisungen an das ModellBestanden
- Keine kritischen Advisories im Paket oder seinen AbhängigkeitenBestanden
README
Auf GitHub ansehenHuntAPI 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 Fragen
Wie füge ich HuntAPI MCP zu Claude Code hinzu?
Führe claude mcp add --env 'HUNTAPI_API_KEY=<YOUR_HUNTAPI_API_KEY>' huntapi-mcp -- npx -y @huntapi/mcp in deinem Terminal aus. Füge --scope user hinzu, damit der Server in jedem Projekt verfügbar ist.
Wie füge ich HuntAPI MCP zu Cursor hinzu?
Öffne ~/.cursor/mcp.json und füge den Server unter mcpServers hinzu, mit der Cursor-Config aus dem Installationsabschnitt oben.
Welche Tools bietet HuntAPI MCP?
Er stellt 7 Tools bereit, darunter audio_download, jobs, media_metadata, stats, usage.
Wie nutze ich HuntAPI mit Claude Desktop?
Du kannst das .mcpb Bundle von der Releases-Seite herunterladen und öffnen oder den Server via npx zu deiner Konfigurationsdatei hinzufügen.
Kann ich Metadaten extrahieren, ohne die gesamte Datei herunterzuladen?
Ja, das media_metadata Tool ermöglicht es dir, Metadaten von einer Medien-URL zu extrahieren, ohne die Datei herunterzuladen.
Was sind die Voraussetzungen, um den Server auszuführen?
Du benötigst Node.js Version 20 oder neuer und einen gültigen HuntAPI API key.
Kostet die Nutzung der Tools etwas?
Ja, jedes Tool, das die API aufruft, verbraucht Credits.