关于 mcp-mobile-phone-waterfall-orchestrator
这是一款 MCP 服务,按顺序使用自有的 Prospeo、Lusha、ContactOut 和 FullEnrich 密钥,为联系人查找电话号码。它通过 Apify 运行查询 Actor,并返回号码详情及供应商积分用量。
主要功能
- 01按顺序查询多个供应商
- 02支持联系人列表或单个联系人
- 03提供 E.164 号码及线路详情
- 04供应商报告时提供拒接来电标记
- 05显示供应商积分用量并支持费用上限
适用场景
- 01为联系人列表查找手机号码
- 02依次尝试已配置的数据供应商
- 03查看号码的国家和线路类型
MCP 相关
向 MCP 客户端提供 `find_mobile_phone` 工具。该工具启动 Apify Actor 并返回其数据集;需要设置 `APIFY_TOKEN`,供应商密钥可选,且从服务端环境读取。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
npx -y @mambalabsdev/mcp-mobile-phone-waterfall-orchestratorAPIFY_TOKEN密钥Apify API token from https://console.apify.com/account/integrationsPROSPEO_API_KEY密钥Optional. Your Prospeo API key.LUSHA_API_KEY密钥Optional. Your Lusha API key (V3).CONTACTOUT_API_KEY密钥Optional. Your ContactOut API token.FULLENRICH_API_KEY密钥Optional. Your FullEnrich API key.本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。
工具
1收录的工具列表 · 更新于 1 周前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| string | 否 | 单联系人快捷方式:电子邮件。 | |
| contacts | array | 否 | 要查询的人员。请为每人提供你掌握的尽可能多的标识信息。 |
| full_name | string | 否 | 单联系人快捷方式:全名。 |
| mobile_only | enum | 否 | 为 true 时,固定电话或 VoIP 号码不计为已找到,查询链会继续。未报告线路类型的号码保留为未知。默认值为 true。true | false |
| linkedin_url | string | 否 | 单联系人快捷方式:LinkedIn 个人资料 URL,执行程序绝不会打开。 |
| max_contacts | string | 否 | 本次运行处理的联系人数量上限。 |
| company_domain | string | 否 | 单联系人快捷方式:公司域名。 |
| max_charge_usd | string | 否 | 本次运行的可选 Apify 费用上限。若某项费用会使总额超出上限,则运行会在产生该费用前停止,并保留所有已付费行。 |
| provider_order | array | 否 | 提供商调用顺序。默认值为 prospeo、lusha、contactout、fullenrich。未设置密钥的提供商会被跳过并报告。 |
| max_provider_credits | string | 否 | 本次运行可在买方自有账户上消耗的提供商积分上限。超出上限后,其余联系人将被跳过且不收费。强烈建议设置。 |
详细介绍
手机号码瀑布流 MCP 服务
按顺序调用你自己的手机号码数据提供商,为每位联系人查找手机号码;如果某个提供商未返回号码,则继续调用下一个。提供商依次为 Prospeo、Lusha、ContactOut 和 FullEnrich。每位联系人占一行,包含 E.164 格式的号码、线路类型、国家/地区、提供商报告的「请勿致电」标记,以及消耗的提供商额度。
它会在 Apify 上运行 Mobile Phone Waterfall actor(Actor ID 6OOgPktf7RIa5XCOP)。
Prospeo 流程已使用真实密钥进行过线上运行(2026-10-19)。Lusha、ContactOut 和 FullEnrich 步骤是根据各提供商的 API 文档构建的,但尚未使用真实密钥运行;每次运行摘要都会在 providers_not_live_verified 下列出它们。不会存储任何密钥。
工具
| 工具 | 功能 |
|---|---|
find_mobile_phone | 使用你自己的提供商密钥,为联系人列表查找手机号码 |
设置
{
"mcpServers": {
"mamba-mobile-phone-waterfall-orchestrator": {
"command": "npx",
"args": ["-y", "@mambalabsdev/mcp-mobile-phone-waterfall-orchestrator"],
"env": {
"APIFY_TOKEN": "your-apify-token",
"PROSPEO_API_KEY": "optional",
"LUSHA_API_KEY": "optional",
"CONTACTOUT_API_KEY": "optional",
"FULLENRICH_API_KEY": "optional"
}
}
}
}
运行此工具需要 APIFY_TOKEN。提供商密钥为可选项,从此 MCP 服务的环境中读取,因此不会经过模型的上下文。如果未设置提供商密钥,运行仍会完成,不会调用任何提供商,且只收取运行启动费用。
输入
contacts(每位联系人可包含 full_name、first_name、last_name、company_domain、company_name、linkedin_url、email、id 中的任意字段),或单个联系人的快捷参数 full_name、company_domain、linkedin_url、email。可选参数:provider_order、mobile_only、max_contacts、max_provider_credits、max_charge_usd。
LinkedIn URL 会作为标识符传递给提供商。此服务和 actor 均不会打开该链接。
运行方式
服务会启动 actor 运行(POST /v2/acts/{id}/runs),轮询其状态(GET /v2/actor-runs/{runId}),直到达到终止状态;运行超时时间为 1,800 秒,然后返回数据集。运行未成功时会以错误形式返回,并附带其运行 ID。
费用
Apify 会按事件向你的 Apify 账户收取 Actor 费用:启动事件费用、每个至少调用了一个提供商的联系人费用,以及每个找到的号码费用。各提供商会在你的密钥上收取各自的积分费用。当前价格请参阅 Actor 的定价标签页。
许可证
MIT。由 Mamba Labs 构建。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。