阿波罗MCP服务器
一种模型上下文协议(MCP)服务器 阿波罗.io -领先的销售情报和参与平台。该服务器提供34多种工具,用于自动化销售推广、潜在客户和管道管理。
特性
人员搜索和丰富 -从Apollo的275M+联系人数据库中查找并丰富联系人数据
组织搜索和丰富 -按行业、规模、地点等搜索公司
电子邮件序列 -通过A/B测试创建和管理自动化的外展活动
联系人管理 -将联系人组织到列表中并管理管道阶段
工作流自动化 -为您的销售流程构建事件驱动的自动化
任务和活动 -创建和跟踪销售活动
交易管道 -通过销售渠道管理机会
分析 -跟踪序列性能和电子邮件传递能力
安装
先决条件
Python 3.10+
一 阿波罗.io 具有API访问权限的帐户
紫外线 (推荐)或pip
使用uv进行安装
复制 # Clone the repository
git clone https://github.com/BlockchainRev/apollo-mcp-server.git
cd apollo-mcp-server
# Install dependencies
uv pip install -e .
使用pip安装
配置
获取Apollo API密钥
登录到 阿波罗.io
首选 设置 > 集成 > API
生成或复制API密钥
设置环境变量
复制 export APOLLO_API_KEY="your-api-key-here"
或者添加到您的shell配置文件中(~/.bashrc, ~/.zshrc等等):
复制 echo 'export APOLLO_API_KEY="your-api-key-here"' >> ~/.zshrc
用法
使用克劳德代码
添加到您的Claude Code MCP配置中(~/.claude.json):
复制 {
"mcpServers": {
"apollo": {
"command": "uv",
"args": ["run", "--directory", "/path/to/apollo-mcp-server", "python", "-m", "apollo_mcp.server"],
"env": {
"APOLLO_API_KEY": "your-api-key-here"
}
}
}
}
独立
复制 # Run the server
python -m apollo_mcp.server
可用工具
人员和联系人(6个工具)
工具
说明
people_search
使用过滤器搜索Apollo的275M+联系人数据库
people_enrich
通过电子邮件、姓名或领英丰富个人资料
contacts_search
在您的Apollo CRM中搜索联系人
组织(3个工具)
工具
说明
organization_search
按行业、规模、地点搜索公司
organization_enrich
按域获取全面的公司数据
organization_job_postings
获取公司当前的招聘信息
电子邮件序列(5个工具)
工具
说明
sequences_list
列出所有电子邮件序列
sequence_get
获取序列详细信息和统计数据
sequence_create
创建多步骤外展序列
sequence_add_contacts
将联系人添加到序列中
sequence_activate
激活或暂停序列
联系人列表(3个工具)
工具
说明
lists_get
获取所有已保存的列表
list_create
创建新联系人列表
list_add_contacts
将联系人添加到列表中
工作流程(7个工具)
工具
说明
workflows_list
列出所有工作流自动化
workflow_get
获取工作流详细信息
workflow_create
创建事件驱动的自动化
workflow_update
更新工作流配置
workflow_activate
激活或停用工作流
workflow_delete
删除工作流
workflow_templates_list
浏览工作流模板
workflow_create_from_template
从模板创建
电子邮件(2个工具)
工具
说明
email_preview
使用变量替换预览电子邮件
email_send
发送一次性电子邮件
任务(2个工具)
工具
说明
tasks_list
列出所有任务
task_create
为联系人创建任务
优惠(2工具)
工具
说明
deals_list
列出管道机会
deal_create
创建新交易
分析(2个工具)
工具
说明
analytics_sequences
获取序列性能指标
analytics_email_accounts
获取电子邮件送达率统计数据
实用工具(4个工具)
工具
说明
get_available_fields
列出电子邮件个性化变量
get_email_schedules
获取发送计划选项
get_contact_stages
获取联系渠道阶段
get_account_stages
获取帐户管道阶段
例子
寻找决策者
复制 # Find VPs of Sales at tech companies in California
people_search(
person_titles=["VP Sales", "Vice President of Sales"],
organization_locations=["California, US"],
organization_num_employees_ranges=["51,200", "201,500"]
)
创建外展序列
复制 sequence_create(
name="New Lead Outreach",
steps=[
{
"type": "auto_email",
"wait_time": 0,
"wait_mode": "minute",
"emailer_touches": [{
"type": "new_thread",
"subject": "Quick question about {{company}}",
"body_html": "<p>Hi {{first_name}},</p><p>I noticed {{company}} is growing...</p>"
}]
},
{
"type": "auto_email",
"wait_time": 3,
"wait_mode": "day",
"emailer_touches": [{
"type": "reply",
"subject": "Re: Quick question about {{company}}",
"body_html": "<p>Following up on my last email...</p>"
}]
}
]
)
创建工作流自动化
复制 workflow_create(
name="New Contact Nurture",
trigger_type="event",
trigger_events=["contact_saved_or_created"],
actions=[
{"type": "add_to_sequence", "config": {"sequence_id": "abc123"}}
]
)
电子邮件个性化变量
在电子邮件模板中使用这些变量:
变量
描述
{{first_name}}
联系人的名字
{{last_name}}
联系人的姓氏
{{company}}
公司名称
{{title}}
职位名称
{{email}}
电子邮件地址
{{city}} 城市
{{state}}
州/地区
{{country}}
国家
API终点
服务器使用两个Apollo API端点:
公共API (api.apollo.io/v1/):人员搜索、丰富
应用程序API (app.apollo.io/api/v1/):序列、工作流、列表等。
所有请求都使用 X-Api-Key 用于身份验证的标头。
发展
项目结构
复制 apollo-mcp-server/
├── apollo_mcp/
│ ├── __init__.py # Package initialization
│ ├── server.py # Main MCP server
│ ├── client.py # HTTP client for Apollo API
│ ├── utils/
│ │ ├── __init__.py
│ │ ├── config.py # Configuration and settings
│ │ └── formatting.py # Output formatting utilities
│ └── tools/
│ ├── __init__.py # Tool registration
│ ├── people.py # People/contact tools
│ ├── organizations.py # Organization tools
│ ├── sequences.py # Email sequence tools
│ ├── lists.py # List management tools
│ ├── workflows.py # Workflow automation tools
│ ├── email.py # Email tools
│ ├── tasks.py # Task management tools
│ ├── deals.py # Deal/opportunity tools
│ ├── analytics.py # Analytics tools
│ └── utility.py # Helper tools
├── examples/
│ └── basic_usage.py # Usage examples
├── pyproject.toml # Project configuration
├── requirements.txt # Dependencies
└── README.md
运行测试
复制 # Install dev dependencies
uv pip install -e ".[dev]"
# Run tests
pytest
贡献
欢迎投稿!拜托:
分叉存储库
创建要素分支
进行更改
提交拉取请求
许可证
MIT许可证-请参阅 许可证 了解详情。
致谢