Apollo数据代理服务

一个开源的、自托管的MCP服务器,用于为AI代理提供直接访问Apollo的B2B销售情报数据库的能力。

  • by AgenTeam-AI-2026
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 AgenTeam-AI-2026/mcp-apollo

使用说明

mcp阿波罗

开源、自托管 Apollo.io的MCP服务器 --让您的AI代理直接访问Apollo的B2B销售情报数据库。

将其部署到 您自己的Cloudflare帐户 不到5分钟。你拥有基础设施,你控制成本。没有共享主机,没有供应商锁定。

由以下人员建造和维护 代理团队麻省理工学院授权。


运作原理

Your Cloudflare Workers account
  └── mcp-apollo Worker  (your deploy, your infra)
        └── MCP client sends requests with your Apollo API key
              └── Worker proxies to Apollo.io API
                    └── Returns enriched data to your agent
  • 你 将Worker部署到您自己的Cloudflare帐户(免费层处理大多数用例)
  • 你 在每个请求上传递您自己的Apollo.io API密钥-Worker从不存储它
  • 没有共享基础设施 --每个用户都运行自己的独立实例

快速部署(5分钟)

先决条件

步骤

# 1. Clone the repo
git clone https://github.com/AgenTeam-AI-2026/mcp-apollo
cd mcp-apollo

# 2. Install dependencies
npm install

# 3. Log in to your Cloudflare account
npx wrangler login

# 4. Deploy
npx wrangler deploy

您的服务器现在位于:

https://mcp-apollo.<your-subdomain>.workers.dev

这是您的个人MCP服务器URL。请在下面的连接配置中使用它。


连接您的MCP客户端

替换 YOUR_WORKER_URL 使用您部署的URL和 YOUR_APOLLO_KEY 使用您的Apollo.io API密钥。

克劳德桌面

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)或 %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "apollo": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://YOUR_WORKER_URL/mcp"],
      "env": {
        "APOLLO_API_KEY": "YOUR_APOLLO_KEY"
      }
    }
  }
}

保存后重新启动Claude Desktop。

克劳德代码

claude mcp add apollo \
  --transport http \
  --url https://YOUR_WORKER_URL/mcp \
  --header "Authorization: Bearer YOUR_APOLLO_KEY"

光标

在 .cursor/mcp.json:

{
  "mcpServers": {
    "apollo": {
      "url": "https://YOUR_WORKER_URL/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_APOLLO_KEY"
      }
    }
  }
}

帆板运动

在 ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "apollo": {
      "serverUrl": "https://YOUR_WORKER_URL/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_APOLLO_KEY"
      }
    }
  }
}

获取Apollo.io API密钥

  1. 登录 阿波罗.io
  2. 首选 设置→ 集成→ API
  3. 点击 创建API密钥
  4. 复制密钥——将其粘贴到上面的MCP客户端配置中

工具

apollo_search_people

在Apollo的数据库中搜索匹配筛选器的人员。

参数 类型 说明
person_titles string[] 职位名称,例如。 ["VP Engineering", "CTO"]
person_seniorities string[] "vp", "c_suite", "director", "manager", "senior"
organization_domains string[] 公司域名,例如。 ["stripe.com"]
person_locations string[] 地点,例如。 ["New York", "San Francisco"]
organization_num_employees_ranges string[] 尺寸范围,例如。 ["51,200", "201,500"]
page number 页码(默认值:1)
per_page number 每页最多25个结果(默认值:10)

apollo_enrich_person

为特定的人获取完整的丰富个人资料。

参数 类型 说明
email string 最可靠的标识符
linkedin_url string LinkedIn个人资料URL
first_name + last_name + organization_name string 名称+公司组合

至少需要一个标识符。


apollo_search_companies

搜索符合条件的公司。

参数 类型 说明
q_organization_keyword_tags string[] 关键词/行业,例如。 ["SaaS", "fintech"]
organization_locations string[] 总部地点
organization_num_employees_ranges string[] 尺寸范围
organization_funding_stages string[] "Seed", "Series A", "Series B" 等等
page number 页面(默认:1)
per_page number 最多25(默认值:10)

apollo_enrich_company

按域名或名称获取完整的公司简介。

参数 类型 说明
domain string 例如。 "stripe.com" --首选
name string 公司名称--回退

回报:描述、员工人数、成立年份、总资金、融资阶段、技术栈、关键字。


apollo_get_job_postings

为公司发布积极的招聘信息——这是一个强烈的购买/招聘信号。

参数 类型 说明
organization_id string 阿波罗组织ID来自 apollo_enrich_company
job_titles string[] 可选过滤器,例如。 ["engineer", "sales"]

apollo_find_email

通过阿波罗个人ID检索一个人的验证电子邮件。

参数 类型 说明
person_id string 阿波罗个人ID来自 apollo_search_people

Apollo.io费率限制

计划 请求/小时
免费 50
基本 200
专业 1000
组织 自定义

服务器在每次响应时返回速率限制元数据(rate_limits.remaining, rate_limits.resetAt).在429错误时,它会返回一条信息性消息——它永远不会无声地失败。


Cloudflare Workers免费版

度量 自由限制
请求量 10000/天
CPU时间 10ms/请求

对于大多数个人或小型团队部署来说,每天10万个请求就足够了。如果超过此值,请升级到 工人带薪计划 (1000万次请求每月5美元)。


本地开发

npm install
npm run dev
# Server runs at http://localhost:8787

运行测试

npm test                                        # unit + RALPH-loop tests
APOLLO_API_KEY=your_key npx vitest run test/e2e # E2E against live Apollo API

叉子上的CI/CD

该仓库包括GitHub Actions工作流:

  • ci.yml --对每次推送运行类型检查、构建检查和测试
  • deploy.yml --在合并时部署到Cloudflare Workers main
  • e2e.yml -针对阿波罗API的夜间E2E测试

要启用自动部署,请在fork中添加以下机密 GitHub→ 设置→ 秘密→ 行动:

秘密 从哪里得到
CLOUDFLARE_API_TOKEN Cloudflare仪表板→ 我的资料→ API令牌→ 创建令牌(使用“编辑Cloudflare Workers”模板)
CLOUDFLARE_ACCOUNT_ID Cloudflare仪表板→ 工人和页面→ 右侧边栏

要启用夜间E2E测试,还可以添加 APOLLO_API_KEY 作为秘密并设置repo变量 APOLLO_E2E_ENABLED 到 true.


安全

  • 您的Apollo API密钥作为 Bearer 令牌在 Authorization 每个请求的标题
  • 工人 从不存储、记录或保存 您的API密钥
  • 每个请求都是无状态的-密钥仅用于该请求的Apollo API调用
  • 您可以控制整个部署,没有数据接触到第三方基础设施

由AgenTeam构建

代理团队 为B2B销售和GTM运营建立人工智能代理团队。 mcp-apollo 是我们发布的几个开源MCP服务器之一,旨在让代理商直接访问现代销售团队所依赖的工具。


许可证

麻省 理工© AgenTeam-AI-2026