非同期REST APIを使用して、公開メディアURLから動画や音声をダウンロードしたり、メタデータを抽出したりします。
別名 huntapi/huntapi-mcp, huntapi-mcp, @huntapi/mcp
- スター
- 0
- ツール
- 7
- ダウンロード数(30日間)
- 327
- 最新バージョン
- 0.1.0
- 最終コミット
- 2026年11月11日
- ライセンス
- MIT
HuntAPI MCPとは
HuntAPIはMCPサーバーです。 非同期REST APIを使用して、公開メディアURLから動画や音声をダウンロードしたり、メタデータを抽出したりします。. 7個のツールを提供しており、audio_download, jobs, media_metadataなどがあります。
プロジェクトのREADMEから生成された概要
HuntAPI MCP server について
HuntAPIは、Model Context Protocolを通じてメディアダウンロードAPIとやり取りするための手段を開発者に提供します。このMCP serverを使用すると、Claude、Cursor、Windsurf、VS CodeなどのAIクライアントが、公開URLからの音声や動画のダウンロード、またはメディアファイルからのメタデータ抽出などのタスクを実行できます。非同期REST APIとして機能するため、ユーザーはタスクを開始した後、後で進捗状況を確認できます。
ユーザーはこのサーバーを複数の方法でデプロイできます。mcp.huntapi.comにあるホスト版を、ヘッダーにAPI keyを含めることでstreamable HTTP経由で使用するか、Node.js 20以降を使用してstdioでローカル実行するかを選択できます。ローカル環境では、環境変数を通じてHuntAPI API keyを渡す必要があります。サーバーには、audio_download、video_download、media_metadata、およびステータス確認用のjobsなど、これらのタスクを管理するための特定のツールが含まれています。また、アカウントのクレジットを確認するusageや、インフラの健全性を監視するstatsなどのユーティリティツールも提供されています。
できること
- 1メディア情報の抽出ファイル全体をダウンロードせずに、特定のメディアURLからメタデータを取得するようAIに依頼します。
- 2音声または動画ファイルのダウンロード公開リンクから動画または音声ファイルのダウンロードプロセスを開始するようクライアントに指示します。
- 3ダウンロード進捗の監視実行中のメディアジョブの現在のステータスと完了率をAIに確認させます。
- 4アカウントのクレジット残高の確認HuntAPIアカウントの現在の使用統計と残りクレジットをリクエストします。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
HuntAPI MCPのインストール方法
フォーマット検証日 2026年11月10日Cursor に追加Gooseに追加Claude CodeにHuntAPI MCPをインストール
$ claude mcp add --env 'HUNTAPI_API_KEY=<YOUR_HUNTAPI_API_KEY>' huntapi-mcp -- npx -y @huntapi/mcpCursorにHuntAPI MCPをインストール
~/.cursor/mcp.json
{
"mcpServers": {
"huntapi-mcp": {
"command": "npx",
"args": [
"-y",
"@huntapi/mcp"
],
"env": {
"HUNTAPI_API_KEY": "<YOUR_HUNTAPI_API_KEY>"
}
}
}
}VS CodeにHuntAPI MCPをインストール
.vscode/mcp.json
{
"servers": {
"huntapi-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@huntapi/mcp"
],
"env": {
"HUNTAPI_API_KEY": "<YOUR_HUNTAPI_API_KEY>"
}
}
}
}VS Code CLIにHuntAPI MCPをインストール
$ code --add-mcp '{"name":"huntapi-mcp","type":"stdio","command":"npx","args":["-y","@huntapi/mcp"],"env":{"HUNTAPI_API_KEY":"<YOUR_HUNTAPI_API_KEY>"}}'Claude DesktopにHuntAPI MCPをインストール
claude_desktop_config.json
{
"mcpServers": {
"huntapi-mcp": {
"command": "npx",
"args": [
"-y",
"@huntapi/mcp"
],
"env": {
"HUNTAPI_API_KEY": "<YOUR_HUNTAPI_API_KEY>"
}
}
}
}CodexにHuntAPI MCPをインストール
$ codex mcp add huntapi-mcp --env 'HUNTAPI_API_KEY=<YOUR_HUNTAPI_API_KEY>' -- npx -y @huntapi/mcpCodex config.tomlにHuntAPI MCPをインストール
~/.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>"
Gemini CLIにHuntAPI MCPをインストール
$ gemini mcp add -s user -e 'HUNTAPI_API_KEY=<YOUR_HUNTAPI_API_KEY>' huntapi-mcp npx -- -y @huntapi/mcpGemini settings.jsonにHuntAPI MCPをインストール
~/.gemini/settings.json
{
"mcpServers": {
"huntapi-mcp": {
"command": "npx",
"args": [
"-y",
"@huntapi/mcp"
],
"env": {
"HUNTAPI_API_KEY": "<YOUR_HUNTAPI_API_KEY>"
}
}
}
}HuntAPI MCPツール 7
READMEから検出audio_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. | 必須シークレット |
自動チェック
実行日 2026年11月12日完全なレポート →自動チェックに合格しました。これはセキュリティ監査ではありません。コードを読み、サーバーに必要最小限のアクセス権を与えてください。 チェックの仕組み
- ソースリポジトリがリンクされており、アクセス可能合格
- オープンソースライセンス (OSI)合格
- 過去1年以内にコミットまたはリリースあり合格
- パッケージ名が有名なパッケージに酷似していない合格
- リモートエンドポイントがHTTPSを使用合格
- 破壊的なツールがラベル付けされている合格
- モデルへの隠れた指示がない合格
- パッケージおよびその依存関係に重大な勧告なし合格
README
GitHubで見る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のよくある質問
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を開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
HuntAPI MCPが提供するツールは
7個のツールを提供しており、audio_download, jobs, media_metadata, stats, usageなどがあります。
Claude DesktopでHuntAPIを使用するにはどうすればよいですか?
releasesページから.mcpb bundleをダウンロードして開くか、npxを使用して設定ファイルにMCP serverを追加してください。
ファイルをすべてダウンロードせずにメタデータを抽出できますか?
はい、media_metadataツールを使用すると、ファイルをダウンロードせずにメディアURLからメタデータを抽出できます。
サーバーを実行するための要件は何ですか?
Node.js version 20以降と、有効なHuntAPI API keyが必要です。
ツールの使用に費用はかかりますか?
はい、APIを呼び出すすべてのツールでクレジットを消費します。