Apollo.io MCP Server Ndg

🚀 Apollo.io MCP 服務器

本項目打造了一個 MCP 服務器，將 Apollo.io API 的各項功能以工具形式對外公開。藉助模型上下文協議（MCP），用戶能夠輕鬆與 Apollo.io API 展開交互。

🚀 快速開始

要使用此 MCP 服務器，您需要完成以下步驟：

1. 將 APOLLO_IO_API_KEY 環境變量設置為您的 Apollo.io API 密鑰。或者在項目根目錄中創建 .env 文件，並添加 APOLLO_IO_API_KEY。
2. 獲取依賴項：uv sync
3. 運行命令：uv run mcp run server.py

✨ 主要特性

組件構成

該項目主要由以下核心組件構成：

• apollo_client.py：定義了用於與 Apollo.io API 交互的 ApolloClient 類。它涵蓋了人物豐富資料、組織豐富資料、人物搜索、組織搜索和組織職位發佈等實用方法。
• server.py：定義了一個 FastMCP 服務器，該服務器將 Apollo.io API 功能作為工具公開。它藉助 apollo_client.py 中定義的 ApolloClient 類與 API 進行交互。
• apollo/：包含 Apollo.io API 的數據模型，例如 PeopleEnrichmentQuery、OrganizationEnrichmentQuery、PeopleSearchQuery、OrganizationSearchQuery 和 OrganizationJobPostingsQuery。

功能展示

以下功能以 MCP 工具的形式對外公開：

• people_enrichment：使用人物豐富資料端點為 1 個人豐富數據。
• organization_enrichment：使用組織豐富資料端點為 1 家公司豐富數據。
• people_search：使用人物搜索端點查找人員。
• organization_search：使用組織搜索端點查找組織。
• organization_job_postings：使用組織職位發佈端點查找特定組織的職位發佈。

📚 詳細文檔

數據模型

apollo/ 目錄包含 Apollo.io API 的數據模型。這些模型用於定義 MCP 工具的輸入和輸出：

• apollo/people.py：定義人物豐富資料端點的數據模型。
• apollo/organization.py：定義組織豐富資料端點的數據模型。
• apollo/people_search.py：定義人物搜索端點的數據模型。
• apollo/organization_search.py：定義組織搜索端點的數據模型。
• apollo/organization_job_postings.py：定義組織職位發佈端點的數據模型。

測試方法

要進行測試，請設置 APOLLO_IO_API_KEY 環境變量，然後運行 uv run apollo_client.py。

與 Claude for Desktop 配合使用

1. 配置 Claude for Desktop 以使用這些 MCP 服務器，通過在您的 claude_desktop_config.json 文件中添加它們：

{
  "mcpServers": {
    "apollo-io-mcp-server": {
      "type": "stdio",
      "command": "uv",
      "args": [
        "run",
        "mcp",
        "run",
        "path/to/apollo-io-mcp-server/server.py"
      ]
    }
  }
}

📦 資源鏈接

• Apollo.io API 文檔
• MCP 協議文檔
• Claude for Desktop 文檔