APIVerve

APIVerve MCP Server

🚀 概要

APIVerve MCP Server は、Model Context Protocol を通じて、すぐに本番環境で利用できる 387 以上の API にシームレスにアクセスできるようにします。Claude、ChatGPT などの AI アシスタントや、その他の MCP 対応クライアントを、データと機能の豊富なエコシステムに接続できます。

✨ 特長

• 🎯 387 以上の API - 天気、ニュース、ジオコーディング、検証、変換など
• 🔐 OAuth 2.0 認証 - 安全な業界標準の認証
• 📊 トークンベースの料金体系 - 使用した分だけお支払いいただけます
• 🚀 高パフォーマンス - クラウドホスト型で、稼働率は 99％以上
• 📖 充実したドキュメント - 例を含む完全な API ドキュメント
• 🔄 自動更新 - 常に最新の API 機能にアクセスできます

📦 インストール

APIVerve はリモート MCP サーバーです。ローカルで実行するものはありません。以下の URL をクライアントに指定すると、サインインまで自動で処理されます。

ワンクリックインストール

このリポジトリは Cursor プラグイン（.cursor-plugin/）および Gemini CLI 拡張機能（gemini-extension.json）としても利用できます。どちらもサーバーに加え、エージェントにツールをいつ、どのように使うかを伝えるスキルを追加します。

Gemini CLI:

gemini extensions install https://github.com/apiverve/mcp-server

クイックセットアップ

npx @apiverve/mcp-server

VS Code と Cursor を設定し、Claude Desktop での手動設定手順を表示します。npx @apiverve/mcp-server cursor を実行すると、対象のクライアントを 1 つ指定できます。

ヘッドレス環境では、サインインの代わりにキーを渡します。

npx @apiverve/mcp-server --api-key YOUR_API_KEY

Python ユーザーも、pip install apiverve-mcp を実行してから apiverve-mcp を実行する（または apiverve-mcp --api-key YOUR_API_KEY を実行する）ことで、同じように利用できます。

手動セットアップ

Claude Desktop — リモートサーバーは設定ファイルではなく、アプリから追加します。

Settings → Connectors → Add custom connector → https://api.apiverve.com/v1/mcp

VS Code（mcp.json）:

{
  "servers": {
    "apiverve": {
      "type": "http",
      "url": "https://api.apiverve.com/v1/mcp"
    }
  }
}

Cursor（~/.cursor/mcp.json）:

{
  "mcpServers": {
    "apiverve": {
      "url": "https://api.apiverve.com/v1/mcp"
    }
  }
}

🔑 認証

認証方法は 2 つあります。用途に合う方を選んでください。

OAuth（デフォルト、推奨） — 上記の設定のままにします。初回使用時にサーバーが認証チャレンジを返し、クライアントがサインイン手順を案内します。キーがディスクに保存されることはなく、ダッシュボードからアクセスを取り消せます。

API キー — キーをヘッダーとして追加します。ブラウザーを利用できない CI やヘッドレス環境に便利です。

{
  "mcpServers": {
    "apiverve": {
      "url": "https://api.apiverve.com/v1/mcp",
      "headers": { "x-api-key": "YOUR_API_KEY" }
    }
  }
}

Claude Desktop のカスタムコネクターではカスタムヘッダーを送信できないため、OAuth のみ利用できます。

https://apiverve.com でキーを取得してください。無料プランをご利用いただけます。利用開始にクレジットカードは必要ありません。

🎯 利用可能な API

利用可能な 387 以上の API をすべて表示するにはクリックしてください

🌤️ 天気と環境

• 天気予報
• 大気質
• 海洋気象
• UV インデックス
• 季節別の天気
• その他...

🌍 位置情報とジオコーディング

• リバースジオコーディング
• IP 検索
• タイムゾーン検索
• 空港検索
• 距離計算
• その他多数…

✅ 検証と確認

• メールアドレス検証
• 電話番号検証
• ドメインの利用可否
• SSL 証明書チェッカー
• その他多数…

🔄 変換と計算

• 通貨換算
• 単位変換
• 日付計算
• BMI 計算
• その他多数…

📰 ニュースとコンテンツ

• 世界のニュース
• RSS から JSON への変換
• ウェブスクレイパー
• メタデータ抽出
• その他多数…

🎲 ランダムデータ生成ツール

• ランダムユーザー生成ツール
• パスワード生成ツール
• Lorem Ipsum 生成ツール
• その他多数…

API の完全な一覧を見る →

💡 使用例

設定が完了したら、会話の中で自然に API を利用できます。

Claude Desktop の場合

User: What's the weather in San Francisco?
Claude: [Uses Weather API]

User: Validate this email: [email protected]
Claude: [Uses Email Validator API]

User: Convert 100 USD to EUR
Claude: [Uses Currency Converter API]

プログラムからの利用（Python）

ローカルプロセスを介さず、リモートサーバーに直接接続します。

from mcp import ClientSession
from mcp.client.streamable_http import streamablehttp_client

url = "https://api.apiverve.com/v1/mcp"
headers = {"x-api-key": "YOUR_API_KEY"}

async with streamablehttp_client(url, headers=headers) as (read, write, _):
    async with ClientSession(read, write) as session:
        await session.initialize()

        # List available tools
        tools = await session.list_tools()

        # Call a tool
        result = await session.call_tool("emailvalidator", {
            "email": "[email protected]"
        })

📊 料金

APIVerve は、ニーズに合わせて複数のプランから選べる柔軟なトークンベースの料金モデルを採用しています。

• 無料プランあり - クレジットカード不要ですぐに開発を始められます
• 従量課金制 - 利用量の増加に応じて拡張できます
• エンタープライズプラン - 大量利用向けのカスタムソリューション

料金プランを見る →

クレジットの消費量は API の複雑さによって異なります。シンプルな API は 1 回の呼び出しにつき 1 クレジットから利用できます。

🛠️ 技術情報

サーバー情報

• トランスポート: Streamable HTTP
• プロトコル: MCP 2025-06-18（2025-03-26 および 2024-11-05 にネゴシエーションでダウングレード）
• 認証: PKCE を使用した OAuth 2.0、または x-api-key ヘッダー
• ベース URL: https://api.apiverve.com/v1/mcp
• API バージョン: 1.1.1

OAuth エンドポイント

• ディスカバリー: https://api.apiverve.com/.well-known/openid-configuration
• 認証: https://api.apiverve.com/authorize
• トークン: https://api.apiverve.com/token
• 登録: https://api.apiverve.com/register（動的クライアント登録）

ツールのスキーマ

各 API は、次の内容を持つ MCP ツールとして公開されます。

• name: API 識別子（例：emailvalidator）
• description: トークン消費量を含む、人が読める説明
• inputSchema: 必須および任意のパラメーターを定義する JSON Schema

🔧 トラブルシューティング

接続の問題

認証エラーが表示される場合：

1. https://apiverve.com/dashboard で API キーを確認します
2. OAuth リダイレクト URI が正しいことを確認します
3. 接続を再認証してみます

トークンの上限

トークンの上限に達した場合：

• https://apiverve.com/dashboard で使用状況を確認します
• プランをアップグレードします
• エンタープライズ向けのオプションについて、サポートにお問い合わせください

📚 ドキュメント

• API ドキュメント: https://docs.apiverve.com
• MCP 仕様: modelcontextprotocol.io
• スタートガイド: https://apiverve.com/docs/getting-started

🤝 サポート

• GitHub の課題: apiverve/mcp-server/issues
• メール: [email protected]
• プライバシーポリシー: apiverve.com/privacy
• Discord: コミュニティに参加

📄 ライセンス

このプロジェクトは MIT ライセンスの下でライセンスされています。詳細は LICENSE ファイルをご覧ください。

🌟 スターをお願いします！

このプロジェクトが役に立った場合は、GitHub のリポジトリにスターを付けていただけると幸いです！

---