Téléchargez des vidéos et de l'audio à partir d'URL média publiques ou extrayez des métadonnées via une API REST asynchrone.
Aussi connu sous huntapi/huntapi-mcp, huntapi-mcp, @huntapi/mcp
- Étoiles
- 0
- Outils
- 7
- Téléchargements, 30 jours
- 327
- Dernière version
- 0.1.0
- Dernier commit
- 11 nov. 2026
- Licence
- MIT
Qu'est-ce que HuntAPI MCP ?
HuntAPI est un serveur MCP. Téléchargez des vidéos et de l'audio à partir d'URL média publiques ou extrayez des métadonnées via une API REST asynchrone. Il expose 7 outils, comme audio_download, jobs, media_metadata.
Résumé généré à partir du README du projet
À propos du MCP server HuntAPI
HuntAPI offre aux développeurs un moyen d'interagir avec une API de téléchargement de médias via le Model Context Protocol. Ce serveur permet à des clients IA tels que Claude, Cursor, Windsurf et VS Code d'effectuer des tâches comme le téléchargement d'audio et de vidéo à partir d'URL publiques ou l'extraction de métadonnées de fichiers média. Il fonctionne comme une API REST asynchrone, ce qui signifie que les utilisateurs peuvent lancer une tâche puis vérifier sa progression ultérieurement.
Les utilisateurs peuvent déployer ce serveur de plusieurs manières. Vous pouvez utiliser la version hébergée sur mcp.huntapi.com via streamable HTTP en fournissant une clé API dans le header, ou l'exécuter localement via stdio avec Node.js 20 ou une version supérieure. Les configurations locales nécessitent une clé API HuntAPI transmise via les variables d'environnement. Le serveur inclut des outils spécifiques pour gérer ces tâches, notamment audio_download, video_download, media_metadata, ainsi que des jobs pour interroger le statut. Il propose également des outils utilitaires comme usage pour vérifier les crédits du compte et stats pour surveiller l'état de l'infrastructure.
Ce que vous pouvez faire avec
- 1Extraire des informations médiaDemandez à l'IA de récupérer les métadonnées d'une URL média spécifique sans télécharger l'intégralité du fichier.
- 2Télécharger des fichiers audio ou vidéoDonnez l'instruction au client de lancer un processus de téléchargement pour un fichier vidéo ou audio à partir d'un lien public.
- 3Surveiller la progression du téléchargementDemandez à l'IA de vérifier le statut actuel et le pourcentage d'avancement d'une tâche média en cours.
- 4Vérifier le solde de crédits du compteDemandez les statistiques d'utilisation actuelles et les crédits restants pour votre compte HuntAPI.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Comment installer HuntAPI MCP
Formats vérifiés le 10 nov. 2026Ajouter à CursorAjouter à GooseInstaller HuntAPI MCP dans Claude Code
$ claude mcp add --env 'HUNTAPI_API_KEY=<YOUR_HUNTAPI_API_KEY>' huntapi-mcp -- npx -y @huntapi/mcpInstaller HuntAPI MCP dans Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"huntapi-mcp": {
"command": "npx",
"args": [
"-y",
"@huntapi/mcp"
],
"env": {
"HUNTAPI_API_KEY": "<YOUR_HUNTAPI_API_KEY>"
}
}
}
}Installer HuntAPI MCP dans VS Code
.vscode/mcp.json
{
"servers": {
"huntapi-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@huntapi/mcp"
],
"env": {
"HUNTAPI_API_KEY": "<YOUR_HUNTAPI_API_KEY>"
}
}
}
}Installer HuntAPI MCP dans 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>"}}'Installer HuntAPI MCP dans Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"huntapi-mcp": {
"command": "npx",
"args": [
"-y",
"@huntapi/mcp"
],
"env": {
"HUNTAPI_API_KEY": "<YOUR_HUNTAPI_API_KEY>"
}
}
}
}Installer HuntAPI MCP dans Codex
$ codex mcp add huntapi-mcp --env 'HUNTAPI_API_KEY=<YOUR_HUNTAPI_API_KEY>' -- npx -y @huntapi/mcpInstaller HuntAPI MCP dans 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>"
Installer HuntAPI MCP dans Gemini CLI
$ gemini mcp add -s user -e 'HUNTAPI_API_KEY=<YOUR_HUNTAPI_API_KEY>' huntapi-mcp npx -- -y @huntapi/mcpInstaller HuntAPI MCP dans Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"huntapi-mcp": {
"command": "npx",
"args": [
"-y",
"@huntapi/mcp"
],
"env": {
"HUNTAPI_API_KEY": "<YOUR_HUNTAPI_API_KEY>"
}
}
}
}Outils MCP HuntAPI 7
Détectés depuis le READMEaudio_downloadjobsmedia_metadatastatsusagevideo_downloadwait_for_job
| audio_download | — | |
| jobs | — | |
| media_metadata | — | |
| stats | — | |
| usage | — | |
| video_download | — | |
| wait_for_job | — |
Configuration
HUNTAPI_API_KEYRequisSecretHuntAPI API key.
| Nom | Description | Type |
|---|---|---|
| HUNTAPI_API_KEY | HuntAPI API key. | RequisSecret |
Vérifications automatisées
Exécuté le 12 nov. 2026Rapport complet →A passé nos vérifications automatisées. Il ne s'agit pas d'un audit de sécurité : lisez le code et donnez au serveur l'accès le plus restreint dont il a besoin. Fonctionnement des vérifications
- Dépôt source lié et accessibleRéussi
- Licence open source (OSI)Réussi
- Commit ou version publiée au cours de l'année écouléeRéussi
- Nom du package non proche d'un package populaireRéussi
- L'endpoint distant utilise HTTPSRéussi
- Les outils destructifs sont étiquetésRéussi
- Aucune instruction cachée destinée au modèleRéussi
- Aucun avis critique dans le package ou ses dépendancesRéussi
README
Voir sur 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.
Questions sur HuntAPI MCP
Comment ajouter HuntAPI MCP à Claude Code ?
Exécutez claude mcp add --env 'HUNTAPI_API_KEY=<YOUR_HUNTAPI_API_KEY>' huntapi-mcp -- npx -y @huntapi/mcp dans votre terminal. Ajoutez --scope user pour le rendre disponible dans tous les projets.
Comment ajouter HuntAPI MCP à Cursor ?
Ouvrez ~/.cursor/mcp.json et ajoutez le serveur sous mcpServers, avec la configuration Cursor indiquée dans la section d'installation ci-dessus.
Quels outils HuntAPI MCP fournit-il ?
Il expose 7 outils, dont audio_download, jobs, media_metadata, stats, usage.
Comment utiliser HuntAPI avec Claude Desktop ?
Vous pouvez télécharger le bundle .mcpb depuis la page des releases et l'ouvrir, ou ajouter le serveur à votre fichier de configuration en utilisant npx.
Puis-je extraire des métadonnées sans télécharger l'intégralité du fichier ?
Oui, l'outil media_metadata vous permet d'extraire les métadonnées d'une URL média sans avoir à télécharger le fichier.
Quels sont les prérequis pour exécuter le serveur ?
Vous avez besoin de Node.js version 20 ou supérieure et d'une clé API HuntAPI valide.
L'utilisation des outils est-elle payante ?
Oui, chaque outil qui appelle l'API consomme des crédits.