AI方舟MCP服务器
一个开源的MCP（模型上下文协议）服务器，使AI代理能够完全访问 AI方舟 API-搜索4亿人以上，69M多家公司，查找经过验证的电子邮件、电话号码，并分析个性。
适用于Cursor、Claude、Windsurf和任何兼容MCP的客户端。
部署
此MCP服务器需要部署到公共URL（用于电子邮件webhook接收）。Fly.io运行良好：
git clone https://github.com/dropoutsanta/ai-ark-mcp.git
cd ai-ark-mcp
fly launch
fly volumes create ark_data --size 1 --region yyz
fly deploy
fly secrets set MCP_BASE_URL=https://your-app.fly.dev然后将其添加到MCP配置中（例如。 ~/.cursor/mcp.json):
{
"mcpServers": {
"ai-ark": {
"url": "https://your-app.fly.dev/mcp"
}
}
}连接时，系统将提示您输入AI Ark API密钥。得到一个在 ai-ark.com→ API → 开发者门户.
你能做什么
搜索人员（即时）
按职位、公司、行业、地点、技能等查找任何人。返回LinkedIn的完整个人资料、工作经历、教育背景——除了电子邮件。
"Find CTOs at software companies in New York with 50-200 employees"搜索公司（即时）
按行业、规模、技术栈、收入、地点搜索6900多万家公司，或查找类似公司。
"Find companies similar to Stripe with 50-200 employees"查找已验证的电子邮件（异步--15-120秒）
在一个流程中搜索人员并获取其经过验证的电子邮件地址：
Step 1: "Find emails for CEOs at SaaS companies in the US"
→ Agent calls export_people_with_email → gets a trackId
Step 2: Agent automatically polls get_export_results(trackId)
→ "processing... 2/5 emails found"
→ "processing... 4/5 emails found"
→ Returns full data with verified emails每封电子邮件都由BounceBan实时验证。您将获得电子邮件地址、验证状态（有效/无效）和MX提供商（谷歌、微软等）。
查找电话号码（即时）
通过LinkedIn URL或公司域名+名称查找手机号码。
"Find the phone number for John Doe at acme.com"
"Get the mobile number for linkedin.com/in/janedoe"反向查找（即时）
有电子邮件或电话号码吗？找出它属于谁——返回完整的个人资料。
"Who is john@example.com?"
"Look up +14155551234"人格分析（即时）
从LinkedIn个人资料中分析任何人的个性。返回DISC评估、五大得分、沟通风格和销售技巧——非常适合个性化推广。
"Analyze the personality of linkedin.com/in/johndoe"检查积分（即时）
"How many AI Ark credits do I have left?"全部10个工具
| 工具 | 功能 | 速度 |
|---|---|---|
search_companies | 按行业、规模、技术、地点、收入搜索6900多万家公司 | 即时 |
search_people | 按职位、技能、资历、公司筛选器搜索4亿多人 | 即时 |
export_people_with_email | 搜索人员+查找他们的验证电子邮件 | Async（15-120s） |
find_emails_by_track_id | 查找以前搜索的结果的电子邮件_人员呼叫 | 异步（15-120s） |
get_export_results | 电子邮件结果投票（导出后致电或find_emails） | 即时 |
get_email_statistics | 电子邮件查找工作的快速进度检查 | 即时 |
reverse_people_lookup | 通过电子邮件或电话号码查找某人 | 即时 |
find_mobile_phone | 通过LinkedIn URL或域名+名称查找电话号码 | 即时 |
analyze_personality | 来自LinkedIn的DISC/Big Five人格分析 | 即时 |
get_credits | 检查剩余API信用额 | 即时 |
电子邮件查找的工作原理
AI Ark的电子邮件发送API是网络连接的-当电子邮件被验证时，它们会将结果发布到您提供的URL。完成后，没有端点可以按ID获取结果。
对于无法公开公共HTTP端点以接收Webhook的AI代理和本地工具来说，这是一个问题。
此MCP服务器通过充当webhook接收器来解决此问题：
- 当您请求电子邮件时，服务器会在其自身上生成一个唯一的回调URL（例如。
https://your-app.fly.dev/webhook/{id}) - 它将该URL作为webhook传递给AI Ark
- AI Ark将电子邮件和POST结果验证回服务器
- 结果存储在磁盘上（飞行卷）
- 当代理人进行民意调查时
get_export_results，它从存储的数据中读取
代理人只是看到：索要电子邮件→ poll → 接收电子邮件。没有暴露webhook复杂性。
这就是为什么服务器需要一个公共URL --它必须可以通过AI Ark的webhook交付来访问。如果你在没有公共URL的情况下在本地运行它，除了与电子邮件相关的工具外，一切都能正常工作。
认证
使用OAuth 2.1。当你第一次从Cursor/Claude连接时，会打开一个浏览器窗口，粘贴你的AI Ark API密钥。之后，您将保持身份验证，即使在服务器重新启动时也是如此（状态将持久化到Fly卷）。每个MCP连接都有自己的凭据，因此您可以同时连接多个API密钥。