Revenuebase MCP Server

🚀 RevenueBase MCP 服務器

RevenueBase MCP 服務器是一個模型上下文協議（MCP）服務器，它提供對 RevenueBase 業界領先的電子郵件驗證 API 的訪問。該服務器使 AI 助手和應用程序能夠以超過 99% 的準確率驗證商業電子郵件，包括通配域名和受防火牆保護的域名。

✨ 主要特性

• 即時電子郵件驗證：即時驗證單個電子郵件地址。
• 批量電子郵件處理：提交併處理大量電子郵件列表。
• 流程管理：監控、取消和跟蹤批量處理作業。
• 信用管理：檢查剩餘的 API 信用額度。
• API 密鑰管理：生成新的 API 密鑰。
• 高準確率：B2B 電子郵件驗證準確率超過 99%。
• 通配域名支持：驗證其他工具無法處理的通配電子郵件域名。
• 防火牆繞過：繞過 Mimecast 和 Barracuda 等電子郵件防火牆。

📚 關於 RevenueBase

RevenueBase 為 B2B 數據提供商提供業界領先的電子郵件驗證服務。憑藉驗證通配域名和受防火牆保護的域名的能力，RevenueBase 確保在其他服務不足的地方實現最高的準確性。

瞭解更多關於 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 服務器出現問題，請在此倉庫中提交問題。