AI Gateway MCP Server

Vercel AI Gateway を通じて複数の AI プロバイダー・モデルに統一的にアクセスできる MCP サーバー。 Web 検索、マルチモデル調査・比較など、LLM を活用した 4 つのツールを提供します。

提供ツール

ask -- AI に質問

任意のモデルに質問を送り、回答を得ます。

search -- Web 検索

検索対応モデルを使って最新情報を取得します。

research -- マルチモデル調査・比較

複数モデルに並列クエリし、結果を統合または比較表示します。

処理フロー:

1. Query Stage: 指定（またはデフォルト）モデルに並列リクエスト
   • search デフォルト: perplexity/sonar, gemini-3-flash, gpt-5-mini
   • ask デフォルト: gpt-5.4, claude-opus-4.6, gemini-3.1-pro-preview, sonar-reasoning-pro
2. Synthesis Stage (synthesize:true): openai/gpt-5.4 が全結果を精査・統合し、矛盾点を指摘、ソースを明記
3. Comparison (synthesize:false): 各モデルの回答をコスト・レイテンシ付きで並列表示

list_models -- モデル一覧

利用可能なモデルの情報（価格・能力・検索コスト）を表示します。

サポートモデル

OpenAI

Anthropic

Google

Perplexity

価格は 1M トークンあたり（USD）

セットアップ

1. 環境変数

Vercel AI Gateway の API キーを取得し、設定します。

プライバシー・データ保持

各プロバイダーへのリクエストに、プライバシー保護のための設定を自動付与します。

ZERO_DATA_RETENTION=true を設定すると、Vercel AI Gateway レベルの ZDR が有効になり、ZDR 契約済みプロバイダーにのみリクエストがルーティングされます。Perplexity は自前で ZDR を保証しているため Gateway ZDR の適用対象外です。

2. MCP 設定

npx で使う場合（推奨）

Claude Code

claude mcp add ai-gateway npx @ayatec/ai-gateway-mcp-server -e AI_GATEWAY_API_KEY=your-key

Claude Desktop / その他の MCP クライアント

{
  "mcpServers": {
    "ai-gateway": {
      "command": "npx",
      "args": ["@ayatec/ai-gateway-mcp-server"],
      "env": {
        "AI_GATEWAY_API_KEY": "your-key"
      }
    }
  }
}

ローカルビルドで使う場合

開発中のバージョンを使いたい場合や、ソースを修正して使いたい場合はこちら。

git clone https://github.com/ayatec/ai-gateway-mcp-server.git
cd ai-gateway-mcp-server
cp .env.example .env
# .env を編集して API キーを設定
pnpm install
pnpm build

Claude Code

claude mcp add ai-gateway node /path/to/ai-gateway-mcp-server/dist/index.js -e AI_GATEWAY_API_KEY=your-key

Claude Desktop / その他の MCP クライアント

{
  "mcpServers": {
    "ai-gateway": {
      "command": "node",
      "args": ["/path/to/ai-gateway-mcp-server/dist/index.js"],
      "env": {
        "AI_GATEWAY_API_KEY": "your-key"
      }
    }
  }
}

開発

コマンド

pnpm install        # 依存パッケージインストール
pnpm build          # ビルド
pnpm dev            # ウォッチモードでビルド
pnpm start          # サーバー起動（ビルド後）
pnpm dev:tool       # ツールの手動テスト
pnpm test           # テスト実行
pnpm test:watch     # テスト（ウォッチモード）
pnpm type-check     # 型チェック
pnpm lint           # ESLint実行
pnpm lint:fix       # ESLint自動修正
pnpm format         # Prettier実行
pnpm format:check   # フォーマットチェック

ローカルテスト

pnpm dev:tool で各ツールを個別にテストできます。

# ask（デフォルト: gpt-5.4）
pnpm dev:tool ask --question "TypeScriptの利点は？"

# ask（モデル指定）
pnpm dev:tool ask --question "Rustとは？" --model "anthropic/claude-sonnet-4.6"

# search（デフォルト: google/gemini-3-flash）
pnpm dev:tool search --query "Vercel AI SDK 最新情報"

# research（4モデル並列検索→統合、デフォルト）
pnpm dev:tool research --query "WebAssemblyの現状と将来"

# research（askモード、比較表示）
pnpm dev:tool research --query "関数型プログラミングの利点" --mode ask --synthesize false

# research（モデル指定）
pnpm dev:tool research --query "latest TypeScript features" --models '["openai/gpt-5.4","perplexity/sonar"]'

# list_models
pnpm dev:tool list_models
pnpm dev:tool list_models --provider openai
pnpm dev:tool list_models --capability search

リリース

Changesets でバージョン管理しています。

1. changeset ファイルを作成して main に push
2. GitHub Actions が自動で CHANGELOG 更新・バージョンバンプ・npm publish

技術スタック

• TypeScript (ESM, NodeNext, strict)
• Vercel AI SDK -- gateway プロバイダーで全モデルに統一アクセス
• MCP SDK -- Model Context Protocol サーバー実装
• Zod -- スキーマバリデーション
• Vitest -- テスト
• Changesets -- バージョン管理・CHANGELOG 自動生成

ライセンス

MIT