Revenuebase MCP Server

🚀 RevenueBase MCP Server

RevenueBase MCP Serverは、業界をリードするRevenueBaseのメール検証APIへのアクセスを提供するModel Context Protocol (MCP) サーバーです。このサーバーを使用すると、AIアシスタントやアプリケーションが、catch-allドメインやファイアウォールで保護されたドメインを含むビジネスメールを99％以上の精度で検証できます。

✨ 主な機能

• リアルタイムメール検証：個々のメールアドレスを即座に検証します。
• バッチメール処理：大量のメールリストを送信して処理します。
• プロセス管理：バッチ処理ジョブを監視、キャンセル、追跡します。
• クレジット管理：残りのAPIクレジットを確認します。
• APIキー管理：新しいAPIキーを生成します。
• 高精度：B2Bメール検証で99％以上の精度を実現します。
• Catch-Allドメイン対応：他のツールでは扱えないCatch-Allメールドメインを検証します。
• ファイアウォール回避：MimecastやBarracudaなどのメールファイアウォールを迂回します。

RevenueBaseについて

RevenueBaseは、B2Bデータプロバイダー向けに特別に構築された、業界をリードするメール検証サービスを提供しています。Catch-Allドメインやファイアウォールで保護されたドメインを検証する機能を備えており、他のサービスでは不十分な部分でも最大限の精度を保証します。

RevenueBaseのメール検証サービスの詳細はこちらをご覧ください：https://revenuebase.ai/email-list-cleaning/

📦 インストール

1. このリポジトリをクローンします：

git clone https://github.com/avivshafir/revenuebase-mcp-server
cd revenuebase-mcp-server

2. uvを使用して依存関係をインストールします：

uv sync

3. RevenueBase APIキーを設定します：

export REVENUEBASE_API_KEY="your_api_key_here"

💻 使用例

サーバーの起動

python server.py

サーバーが起動し、MCP接続が可能になります。

MCPクライアントでの使用

Claude Desktop

このサーバーをClaude Desktopで使用するには、Claude Desktopの設定ファイルに以下の設定を追加します。

macOS：~/Library/Application Support/Claude/claude_desktop_config.json Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "revenuebase": {
      "command": "uv",
      "args": ["--directory", "/path/to/revenuebase-mcp-server", "run", "python", "server.py"],
      "env": {
        "REVENUEBASE_API_KEY": "your_api_key_here"
      }
    }
  }
}

/path/to/revenuebase-mcp-server を実際のクローンしたリポジトリのパスに、your_api_key_here を実際のRevenueBase APIキーに置き換えてください。

その他のMCPクライアント

他のMCPクライアントの場合、stdioトランスポートを使用してサーバーに接続できます。サーバーは標準的なMCPサーバーとして動作し、stdin/stdoutで接続を受け付けます。

MCP Python SDKを使用した例：

from mcp import ClientSession, StdioServerParameters
from mcp.client.stdio import stdio_client

server_params = StdioServerParameters(
    command="python",
    args=["server.py"],
    env={"REVENUEBASE_API_KEY": "your_api_key_here"}
)

async with stdio_client(server_params) as (read, write):
    async with ClientSession(read, write) as session:
        # 接続を初期化する
        await session.initialize()
        
        # 利用可能なツールをリストする
        tools = await session.list_tools()
        print("利用可能なツール:", [tool.name for tool in tools.tools])
        
        # ツールを呼び出す
        result = await session.call_tool("real_time_email_verification", {
            "email": "test@example.com"
        })
        print("検証結果:", result)

利用可能なツール

1. リアルタイムメール検証

単一のメールアドレスを即座に検証します。

パラメーター：

• email (文字列)：検証するメールアドレス

例：

real_time_email_verification("user@example.com")

2. バッチメール送信

バッチメール処理のためにファイル参照を送信します。

パラメーター：

• filename (文字列)：バッチ処理のためのファイル名参照

例：

batch_email_submission("email_list.csv")

3. バッチ処理ステータス

バッチメール処理ジョブのステータスを確認します。

パラメーター：

• process_id (整数)：バッチ処理ジョブのID

例：

batch_process_email_status(12345)

4. キューに入っているプロセス

キューに入っているすべてのメールバッチ処理ジョブをリストします。

例：

queued_process()

5. プロセスのキャンセル

進行中またはキューに入っているバッチメール処理ジョブをキャンセルします。

パラメーター：

• process_id (整数)：キャンセルするプロセスのID

例：

cancel_process(12345)

6. クレジットの取得

アカウントの残りクレジット数を取得します。

例：

get_credits()

7. 新しいAPIキーの生成

新しいAPIキーを生成して返します。

例：

new_api_key()

📚 ドキュメント

環境変数

• REVENUEBASE_API_KEY：RevenueBase APIキー（必須）

APIエンドポイント

サーバーは以下のRevenueBase APIエンドポイントに接続します。

• https://api.revenuebase.ai/v1/process-email - リアルタイムメール検証
• https://api.revenuebase.ai/v1/batch-process-email - バッチメール送信
• https://api.revenuebase.ai/v1/batch-process-email-status - バッチステータス確認
• https://api.revenuebase.ai/v1/queued-process - キューに入っているプロセスのリスト
• https://api.revenuebase.ai/v1/cancel-process - プロセスのキャンセル
• https://api.revenuebase.ai/v1/credits - クレジットの取得
• https://api.revenuebase.ai/v1/new-api-key - 新しいAPIキーの生成

🔧 技術詳細

すべてのツールには適切なエラー処理が含まれており、APIキーが設定されていない場合は RuntimeError が発生します。RevenueBase APIからのHTTPエラーは、requests.raise_for_status() を使用して自動的に発生させられます。

必要条件

• Python 3.7以上
• fastmcp
• requests

📄 ライセンス

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

サポート

RevenueBase APIのサポートとドキュメントについては、以下のリンクをご覧ください。

• RevenueBaseメール検証
• RevenueBase APIドキュメント

このMCPサーバーに関する問題は、このリポジトリにissueを立ててください。