mcp-apollo

mcp-apollo

一个用于 Apollo.io 的开源、可自托管 MCP 服务——让你的 AI Agent 直接访问 Apollo 的 B2B 销售情报数据库。

不到 5 分钟即可将其部署到你自己的 Cloudflare 账户。基础设施由你拥有，成本由你掌控。无需共享托管，也不会被供应商锁定。

由 AgenTeam 构建和维护。采用 MIT 许可证。

---

工作原理

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 分钟）

前置条件

• Node.js 18+
• 一个 Cloudflare 账户（免费套餐即可）
• 一个 Apollo.io API 密钥

步骤

# 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 密钥。

Claude Desktop

编辑 ~/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 Code

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

Cursor

在 .cursor/mcp.json 中：

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

Windsurf

在 ~/.codeium/windsurf/mcp_config.json 中：

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

---

获取 Apollo.io API 密钥

1. 登录 apollo.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

获取公司的有效招聘信息——这是强烈的采购／招聘信号。

Parameter	Type	Description
organization_id	string	来自 apollo_enrich_company 的 Apollo 组织 ID
job_titles	string[]	可选筛选条件，例如：["engineer", "sales"]

---

apollo_find_email

通过 Apollo 人员 ID 获取此人的已验证邮箱。

Parameter	Type	Description
person_id	string	来自 apollo_search_people 的 Apollo 人员 ID

---

Apollo.io 速率限制

Plan	Requests / hour
Free	50
Basic	200
Professional	1,000
Organization	Custom

服务会在每次响应中返回速率限制元数据（rate_limits.remaining、rate_limits.resetAt）。出现 429 错误时，服务会返回明确的提示信息，不会静默失败。

---

Cloudflare Workers 免费套餐

Metric	Free limit
Requests	100,000 / day
CPU time	10ms / request

每天 10 万次请求足以满足大多数个人或小团队部署的需求。如果超出限制，请升级到 Workers 付费套餐（每月 5 美元，可处理 1,000 万次请求）。

---

本地开发

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

---

在你的 fork 上设置 CI/CD

此仓库包含 GitHub Actions 工作流：

• ci.yml —— 每次推送时运行类型检查、构建检查和测试
• deploy.yml —— 合并到 main 时部署到 Cloudflare Workers
• e2e.yml —— 每晚针对 Apollo API 运行端到端测试

要启用自动部署，请在你的 fork 中前往 GitHub → Settings → Secrets → Actions 添加以下机密：

Secret	Where to get it
CLOUDFLARE_API_TOKEN	Cloudflare 控制面板 → My Profile → API Tokens → Create Token（使用“Edit Cloudflare Workers”模板）
CLOUDFLARE_ACCOUNT_ID	Cloudflare 控制面板 → Workers & Pages → 右侧边栏

要启用每晚的端到端测试，还需将 APOLLO_API_KEY 添加为机密，并将仓库变量 APOLLO_E2E_ENABLED 设置为 true。

---

安全性

• 每次请求都会将你的 Apollo API 密钥作为 Bearer 令牌放在 Authorization 标头中
• Worker 绝不会存储、记录或持久化你的 API 密钥
• 每次请求都是无状态的——密钥仅用于该请求对 Apollo API 的调用
• 你可以完全掌控整个部署——数据不会经过任何第三方基础设施

---

由 AgenTeam 构建

AgenTeam 为 B2B 销售和 GTM 运营构建 AI Agent 团队。mcp-apollo 是我们发布的多个开源 MCP 服务之一，旨在让 Agent 直接使用现代销售团队依赖的工具。

---

许可证

MIT © AgenTeam-AI-2026