Скачивайте видео и аудио по публичным ссылкам или извлекайте метаданные с помощью асинхронного REST API.
Также известен как huntapi/huntapi-mcp, huntapi-mcp, @huntapi/mcp
- Звёзды
- 0
- Инструменты
- 7
- Загрузки, 30 дней
- 327
- Последняя версия
- 0.1.0
- Последний коммит
- 11 нояб. 2026 г.
- Лицензия
- MIT
Что такое HuntAPI MCP?
HuntAPI — это MCP server. Скачивайте видео и аудио по публичным ссылкам или извлекайте метаданные с помощью асинхронного REST API. Он предоставляет 7 инструментов, например audio_download, jobs, media_metadata.
Сводка сгенерирована из README проекта
О HuntAPI MCP server
HuntAPI предоставляет разработчикам возможность взаимодействовать с API для загрузки медиафайлов через Model Context Protocol. Этот MCP server позволяет ИИ-клиентам, таким как Claude, Cursor, Windsurf и VS Code, выполнять такие задачи, как скачивание аудио и видео по публичным ссылкам или извлечение метаданных из медиафайлов. Он работает как асинхронный REST API, что позволяет пользователям запускать задачу, а затем проверять её статус позже.
Пользователи могут развернуть этот сервер несколькими способами. Вы можете использовать хостинговую версию на mcp.huntapi.com через streamable HTTP, передав API ключ в заголовке, или запустить его локально через stdio, используя Node.js 20 или выше. Для локальной настройки требуется передать API ключ HuntAPI через переменные окружения. Сервер включает специализированные инструменты для управления задачами, такие как audio_download, video_download, media_metadata, а также задачи для проверки статуса (polling). Также доступны вспомогательные инструменты, например usage для проверки кредитов аккаунта и stats для мониторинга состояния инфраструктуры.
Что вы можете с ним делать
- 1Извлечение информации о медиафайлахПопросите ИИ получить метаданные по конкретной ссылке на медиафайл без его полной загрузки.
- 2Скачивание аудио или видеоДайте клиенту команду начать процесс загрузки видео или аудиофайла по публичной ссылке.
- 3Мониторинг прогресса загрузкиПопросите ИИ проверить текущий статус и процент выполнения активной задачи по обработке медиа.
- 4Проверка баланса кредитовЗапросите текущую статистику использования и остаток кредитов на вашем аккаунте HuntAPI.
Взято из README проекта. Каждый вариант использования проверен на соответствие цитате из него.
Как установить HuntAPI MCP
Форматы проверены 10 ноя 2026Добавить в CursorДобавить в GooseУстановка HuntAPI MCP в Claude Code
$ claude mcp add --env 'HUNTAPI_API_KEY=<YOUR_HUNTAPI_API_KEY>' huntapi-mcp -- npx -y @huntapi/mcpУстановка HuntAPI MCP в Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"huntapi-mcp": {
"command": "npx",
"args": [
"-y",
"@huntapi/mcp"
],
"env": {
"HUNTAPI_API_KEY": "<YOUR_HUNTAPI_API_KEY>"
}
}
}
}Установка HuntAPI MCP в VS Code
.vscode/mcp.json
{
"servers": {
"huntapi-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@huntapi/mcp"
],
"env": {
"HUNTAPI_API_KEY": "<YOUR_HUNTAPI_API_KEY>"
}
}
}
}Установка HuntAPI MCP в 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>"}}'Установка HuntAPI MCP в Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"huntapi-mcp": {
"command": "npx",
"args": [
"-y",
"@huntapi/mcp"
],
"env": {
"HUNTAPI_API_KEY": "<YOUR_HUNTAPI_API_KEY>"
}
}
}
}Установка HuntAPI MCP в Codex
$ codex mcp add huntapi-mcp --env 'HUNTAPI_API_KEY=<YOUR_HUNTAPI_API_KEY>' -- npx -y @huntapi/mcpУстановка HuntAPI MCP в 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>"
Установка HuntAPI MCP в Gemini CLI
$ gemini mcp add -s user -e 'HUNTAPI_API_KEY=<YOUR_HUNTAPI_API_KEY>' huntapi-mcp npx -- -y @huntapi/mcpУстановка HuntAPI MCP в Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"huntapi-mcp": {
"command": "npx",
"args": [
"-y",
"@huntapi/mcp"
],
"env": {
"HUNTAPI_API_KEY": "<YOUR_HUNTAPI_API_KEY>"
}
}
}
}Инструменты HuntAPI MCP 7
Определено из READMEaudio_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. | ОбязательноСекрет |
Автоматические проверки
Запущено 12 нояб. 2026 г.Полный отчёт →Прошло наши автоматизированные проверки. Это не аудит безопасности: изучите код и предоставьте серверу минимально необходимый доступ. Как работают проверки
- Связанный и доступный исходный репозиторийПройдено
- Open source лицензия (OSI)Пройдено
- Коммит или релиз за последний годПройдено
- Имя пакета не похоже на популярный пакетПройдено
- Удаленная конечная точка использует HTTPSПройдено
- Деструктивные инструменты помеченыПройдено
- Нет скрытых инструкций для моделиПройдено
- Нет критических предупреждений в пакете или его зависимостяхПройдено
README
Открыть на 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.
Вопросы о 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.
Как использовать HuntAPI с Claude Desktop?
Вы можете скачать .mcpb bundle со страницы релизов и открыть его или добавить сервер в конфигурационный файл с помощью npx.
Можно ли извлечь метаданные, не скачивая файл целиком?
Да, инструмент media_metadata позволяет извлекать метаданные из медиа-URL без загрузки самого файла.
Какие требования для запуска сервера?
Вам понадобятся Node.js версии 20 или выше и действующий API ключ HuntAPI.
Платное ли использование инструментов?
Да, каждый вызов API через инструменты расходует кредиты.