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分钟)
### 先决条件
- Node.js 18+
- A. Cloudflare帐户 (免费等级就足够了)
- 一 Apollo.io API密钥
### 步骤```bash
# 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..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):```json
{
"mcpServers": {
"apollo": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://YOUR_WORKER_URL/mcp"],
"env": {
"APOLLO_API_KEY": "YOUR_APOLLO_KEY"
}
}
}
}
保存后重新启动Claude Desktop。
克劳德代码```bash
claude mcp add apollo \
--transport http \
--url https://YOUR_WORKER_URL/mcp \
--header "Authorization: Bearer YOUR_APOLLO_KEY"
### 光标
在 `.cursor/mcp.json`:```json
{
"mcpServers": {
"apollo": {
"url": "https://YOUR_WORKER_URL/mcp",
"headers": {
"Authorization": "Bearer YOUR_APOLLO_KEY"
}
}
}
}
帆板运动
在 ~/.codeium/windsurf/mcp_config.json:```json
{
"mcpServers": {
"apollo": {
"serverUrl": "https://YOUR_WORKER_URL/mcp",
"headers": {
"Authorization": "Bearer YOUR_APOLLO_KEY"
}
}
}
}
______________________________________________________________________
## 获取Apollo.io API密钥
1. 登录 阿波罗.io
1. 首选 **设置→ 集成→ API**
1. 点击 **创建API密钥**
1. 复制密钥——将其粘贴到上面的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美元)。
______________________________________________________________________
## 本地开发```bash
npm install
npm run dev
# Server runs at http://localhost:8787
运行测试```bash
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 Workersmaine2e.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
