Apiany Mcp

APIAny MCP

APIAny のモデル検索、料金情報の確認、ドキュメントの検索、OpenAI 互換の連携例を提供する公式 MCP サーバーです。

APIAny は、チャット、画像、動画、マルチモーダルのワークフローで利用できる 100 以上の AI モデルを、エージェントや開発者に提供します。

クイックスタート · ビジュアルセットアップ · MCP ツール · エージェントスキル · 開発

英語 | 中国語

このリポジトリでできること

APIAny MCP は、AI エージェントが APIAny を理解し、利用するための構造化された方法を提供します。

• プロバイダー、モダリティ、機能、料金のメタデータに基づいて、APIAny の公開モデルを検索できます。
• モデルの選択やワークフローの実行前に、APIAny クレジットを見積もることができます。
• APIAny のドキュメントと llms.txt から、簡潔なドキュメント情報を取得できます。
• OpenAI 互換の cURL、Python、JavaScript、Go、Java、PHP の例を生成できます。
• API キーが設定され、ユーザーが有料利用を明示的に確認した場合にのみ、画像または動画の生成タスクを作成できます。
• skills/apiany-integration にエージェントスキルをパッケージ化し、対応するエージェントが APIAny のワークフローを学習できるようにします。

クイックスタート

npm でサーバーを直接実行します。

npx -y @apiany-ai/mcp

または、このリポジトリからインストールして実行します。

git clone [email protected]:ailingqu/ApiAny.AI-MCP.git
cd ApiAny.AI-MCP
npm install
npm start

ビジュアルセットアップ

1. MCP サーバーをインストールして起動する

2. エージェントクライアントに APIAny MCP を追加する

Claude Code、Cursor、VS Code、またはその他の MCP 互換クライアントで、次の設定を使用します。

{
  "mcpServers": {
    "apiany": {
      "command": "npx",
      "args": ["-y", "@apiany-ai/mcp"],
      "env": {
        "APIANY_BASE_URL": "https://apiany.ai"
      }
    }
  }
}

有料の画像または動画タスクのツールを使用する場合は、APIANY_API_KEY も設定してください。

{
  "APIANY_BASE_URL": "https://apiany.ai",
  "APIANY_API_KEY": "your_apiany_api_key"
}

3. エージェントに APIAny の使用を依頼する

プロンプトの例：

Use APIAny MCP to find an image model for product photos, compare pricing, and show JavaScript integration code.

Use APIAny MCP to estimate credits for 20 gpt-style chat requests with 10k input tokens and 5k output tokens.

Use APIAny MCP to show JavaScript usage for nano-banana-pro and Python usage for veo3-1-fast.

MCP ツール

ツール	目的	API キー
list_models	料金と機能のメタデータを含む、公開 APIAny モデルの一覧を取得します。	不要
search_models	テキスト、プロバイダー、モダリティ、機能でモデルを検索します。	不要
get_model	モデル ID または表示名で公開モデルを 1 つ取得します。	不要
estimate_cost	公開料金メタデータからクレジットを見積もります。	不要
get_model_usage	モデルのエンドポイント、ペイロード、非同期動作、言語別の例を返します。	不要
get_integration_examples	cURL、Python、JavaScript、Go、Java、PHP の例を返します。	不要
get_docs_context	/llms.txt から APIAny ドキュメントの簡潔なコンテキストを返します。	不要
create_image_task	明示的な確認後に、有料の非同期画像タスクを作成します。	必要
create_video_task	明示的な確認後に、有料の非同期動画タスクを作成します。	必要
get_task_status	非同期メディアタスクのステータスを読み取ります。	必要

エージェントスキル

APIAny Integration スキルは skills/apiany-integration にあります。

このスキルは、エージェントが以下を行うのに役立ちます。

• モダリティ、プロバイダー、料金、機能に基づいて APIAny モデルを選択します。
• チャット、画像、動画、メディアのワークフロー向けの例を生成します。
• 非同期タスクの作成とポーリングについて説明します。
• 有料の生成タスクを実行する前に、明示的な確認を必須にします。

環境変数

変数	必須	説明
APIANY_BASE_URL	いいえ	APIAny のベース URL です。デフォルトは https://apiany.ai です。
APIANY_API_KEY	有料ツールでのみ必要	有料の画像／動画タスクの作成とタスクのポーリングに使用する API キーです。

安全性モデル

読み取り専用ツールは API キーなしで動作します。有料の生成ツールには、以下の両方が必要です。

• APIANY_API_KEY
• confirm_paid_request=true

サーバーは API キーを永続化しません。現在のプロセス環境からのみ読み取ります。

開発

npm install
npm run check
npx -y @modelcontextprotocol/inspector node src/server.js

関連ファイル：

• src/server.js：MCP サーバーの実装です。
• examples/mcp.json：クライアント設定の例です。
• docs/distribution.md：npm、MCP ディレクトリ、スキルマーケットプレイス向けのリリースチェックリストです。
• CHANGELOG.md：リリース履歴です。

リンク

• ウェブサイト：https://apiany.ai
• GitHub：https://github.com/ailingqu/ApiAny.AI-MCP
• npm：https://www.npmjs.com/package/@apiany-ai/mcp
• モデル：https://apiany.ai/models
• ドキュメントのコンテキスト：https://apiany.ai/llms.txt

ライセンス

MIT