HuntAPI

HuntAPI MCP サーバー

HuntAPI のメディアダウンロード API 用の公式 Model Context Protocol サーバーです。

1 つの非同期 REST API で、公開されているメディア URL から動画や音声をダウンロードしたり、メタデータを抽出したりできます。

Claude、Cursor、VS Code、Windsurf、および任意の MCP クライアントから、ツールとして API を呼び出せます。stdio（ローカル）または Streamable HTTP（セルフホスト可能）で動作します。

要件

• Node.js 20 以降
• HuntAPI API キー — 登録してから、ダッシュボードでコピーしてください

ホスト型サーバー（推奨）

HuntAPI が https://mcp.huntapi.com/（Streamable HTTP）でこのサーバーを実行します。x-api-key ヘッダーに API キーを指定してください。インストールは不要です。

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"
      }
    }
  }
}

ホスト型サーバーとこのパッケージは同じ API を公開します。stdio を使いたい場合や、独自のネットワーク経路で接続したい場合、またはセルフホストしたい場合は、パッケージをローカルで実行してください。

ローカルで実行する

Claude Code

claude mcp add huntapi --env HUNTAPI_API_KEY=YOUR_API_KEY -- npx -y @huntapi/mcp

Claude Desktop、Cursor、Windsurf、その他のクライアント

クライアントの MCP 設定（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 拡張機能

リリースページから .mcpb バンドルをダウンロードして開くと、Claude Desktop で API キーの入力を求められます。

Docker

docker build -t huntapi-mcp .
docker run -i --rm -e HUNTAPI_API_KEY=YOUR_API_KEY huntapi-mcp

ツール

ツール	説明
audio_download	HuntAPI 経由で URL から音声をダウンロードし、ジョブ ID を受け取ります。
jobs	非同期 HuntAPI ジョブのステータス、進捗状況（0～100）、結果を確認します。
media_metadata	ファイルをダウンロードせずに、メディア URL からメタデータを抽出します。
stats	過去 1 時間のエンジンまたはエンドポイントのインフラストラクチャの稼働状況を確認します。アカウントやテナント単位ではありません。アカウントごとに有効化が必要です。HTTP 403 が返された場合は、サポートに連絡して有効化してください。
usage	Huntapi アカウントのリアルタイムの使用状況統計とクレジット残高を取得します。
video_download	動画をダウンロードします。
wait_for_job	非同期ダウンロードジョブの完了を待ちます。

API を呼び出す各ツールはクレジットを消費します。JSON の結果はテキストとして返されます。画像はインラインで返され、その他のファイル（PDF など）は最大 4 MB まで埋め込みリソースとして返されます。

Streamable HTTP

npx @huntapi/mcp --http --port 3000

エンドポイントは POST /mcp です（ステートレス、JSON レスポンス）。各クライアントは x-api-key ヘッダー（または Authorization: Bearer <key>）にそれぞれのキーを指定します。サーバーが独自のキーを使用することはありません。デフォルトでは 127.0.0.1 にバインドされ、許可しない限りブラウザーのオリジンからのリクエストを拒否します。外部に公開する前に、TLS を介して接続してください。

createHttpHandler() は Fetch 互換のランタイム（Cloudflare Workers、Deno、Bun）向けにエクスポートされています。

import { createHttpHandler } from "@huntapi/mcp";

export default { fetch: createHttpHandler({ allowedOrigins: [] }) };

セキュリティ

• API キーは HUNTAPI_API_KEY（stdio）またはリクエストヘッダー（HTTP）から読み込まれ、エラーメッセージから削除されます。
• ウェブサイトから取得したコンテンツは信頼できないため、サーバーの指示では、モデルに対してそれを指示ではなくデータとして扱うよう伝えています。
• 脆弱性の報告については、SECURITY.md を参照してください。

開発

npm install
npm test
npm run build
npx @modelcontextprotocol/inspector node dist/stdio.js

SDK を基盤として構築

このサーバーは、公式の Node.js SDK（@huntapi/sdk）を使用しています。

HuntAPI のすべての SDK

SDK	パッケージ	インストール
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	ソースからビルドしてください。README を参照してください
CLI	@huntapi/cli	npm install -g @huntapi/cli
MCP サーバー	@huntapi/mcp	npx -y @huntapi/mcp

ライセンス

MIT — LICENSE を参照してください。