🚀 LeadMagic MCP服务器
⚡ B2B数据丰富的终极模型上下文协议服务器
*将LeadMagic的完整API套件与Claude、Cursor、Windsurf和所有兼容MCP的人工智能工具无缝集成*
______________________________________________________________________
🎯 19个强大的工具🔥 零配置•⚡ 单线设置•🛡️ 企业安全
______________________________________________________________________
📖 目录
______________________________________________________________________
🎯 通过模型上下文协议访问所有19个LeadMagic API端点，以便与Claude、Cursor、Windsurf、Continue.dev和其他兼容MCP的人工智能工具无缝集成。
🚀 安装超级简单
⚡ 选项1：交互式安装程序（推荐）
最简单的开始方法-工作 macOS, 视窗，以及 Linux。我们新的交互式安装程序使用React和Ink构建，使安装变得轻而易举。
# 🔥 Using npx (no installation required)
npx leadmagic-mcp-server install✨ 安装程序将：
- ✅ 验证API密钥 实时显示您剩余的积分。
- ✅ 自动检测和配置您首选的AI工具（Claude、Cursor、VS Code等）。
- ✅ 创建所有必要的配置文件和本地
.env为了发展。 - ✅ 提供使用示例和有用链接。
📱 选项2：快速手动设置
如果您更喜欢手动设置或使用类似的客户端 帮助，您可以将服务器配置直接添加到客户端的设置文件中。交互式安装程序为此提供了可复制粘贴的代码段。
运行安装程序并选择“其他（手动设置）”选项：
npx leadmagic-mcp-server install🔑 获取API密钥
- 🌐 访问 LeadMagic仪表板
- 📝 免费注册（如果需要）
- 🔐 生成API密钥
- 📋 出现提示时将其粘贴到交互式安装程序中。
⚡ npx使用（零安装）
您可以在不安装的情况下使用服务器，这非常适合快速测试或容器化环境：
# 🚀 Run directly with your API key
LEADMAGIC_API_KEY=your-key npx leadmagic-mcp-server
# 📋 Run the interactive installer
npx leadmagic-mcp-server install
# ❓ Check available commands
npx leadmagic-mcp-server --help______________________________________________________________________
🛠️ 可用工具
📊 核心操作（3个工具）
- 💳
get_credits-检查API信用余额 - ✅
validate_email-验证电子邮件的可送达性并获取公司信息 - 📧
find_email-按姓名和公司查找经过验证的电子邮件地址
🏢 个人资料和公司情报（5个工具）
- 👤
search_profile-获取完整的B2B配置文件详细信息（需要300次/分钟） - 🏭
search_company-按域名、名称或个人资料URL搜索公司 - 📱
find_mobile-从个人资料/电子邮件中查找手机号码 - 🔗
email_to_profile-从工作电子邮件中查找B2B个人资料URL - 💰
get_company_funding-获取资金、财务和竞争对手数据
✉️ 高级电子邮件查找（2个工具）
- 📨
find_personal_email-从B2B个人资料中查找个人电子邮件 - 🔄
social_to_work_email-从社交资料中查找工作电子邮件
💼 工作和员工智能（5个工具）
- 🔍
find_jobs-使用高级过滤器搜索招聘信息 - 👔
find_role-查找公司内部的特定角色 - 👥
find_employees-查找特定公司的员工 - 🌍
get_job_countries-获取可用的求职国家 - 📋
get_job_types-获取可用于筛选的作业类型
📱 广告智能（4个工具）
- 🔍
search_google_ads-按公司搜索谷歌广告 - 📘
search_meta_ads-搜索元（脸书/Instagram）广告 - 📈
search_b2b_ads-搜索B2B广告活动 - 📄
get_b2b_ad_details-获取详细的B2B广告信息
______________________________________________________________________
💡 使用示例
安装后，您可以在AI工具中使用自然语言命令：
📧 电子邮件操作
"Find the email for John Doe at Microsoft"
"Validate the email john@acme.com"
"Find personal email for B2B profile https://linkedin.com/in/johndoe"🏢 公司情报
"Search for Tesla company information"
"Get funding information for Stripe"
"Find employees at OpenAI who work in engineering"💼 职位与招聘
"Find software engineer jobs at tech companies"
"Search for product manager roles in San Francisco"
"Find mobile number for this B2B profile"📱 竞品分析
"Search for Google Ads from competitor.com"
"Find Meta ads for company XYZ"
"Get B2B advertising campaigns for stripe.com"______________________________________________________________________
🔧 开发设置
📋 先决条件
- 📦 Node.js 18.0.0或更高版本
- 🔑 来自的LeadMagic API密钥 leadmagic.io
💻 地方发展
# 📥 Clone the repository
git clone https://github.com/LeadMagic/leadmagic-mcp.git
cd leadmagic-mcp
# 📦 Install dependencies
npm install
# 🔐 Create environment file
echo "LEADMAGIC_API_KEY=your-api-key-here" > .env
# 🚀 Start development server
npm run dev
# 🏗️ Build for production
npm run build
# ✅ Run validation
npm run validate🔍 MCP检验员测试
# 🚀 Start the MCP inspector
npm run inspector
# 🌐 Open the provided URL in your browser to test all tools______________________________________________________________________
🌐 支持的MCP客户端
| 客户端 | 安装 | 状态 | 注意事项 |
|---|---|---|---|
| 🤖 克劳德桌面 | 交互式安装程序或手动配置 | ✅ 完全支持 | 官方Anthropic客户 |
| 🎯 光标（线） | 交互式安装程序或VS代码设置 | ✅ 完全支持 | 需要Cline扩展 |
| 🏄 帆板运动 | 交互式安装程序或手动配置 | ✅ 完全支持 | Codeium的AI IDE |
| 🔄 Continue.dev | 交互式安装程序或配置文件 | ✅ 完全支持 | 开源编码助手 |
| 💻 VS代码（临床） | VS代码设置.json | ✅ 完全支持 | 需要Cline扩展 |
| 💻 VS代码（继续） | 继续扩展配置 | ✅ 完全支持 | 需要继续扩展 |
| ⚡ Zed编辑 | 交互式安装程序或设置 | ✅ 完全支持 | 现代代码编辑器 |
| 🤖 帮助 | 手动配置 | ✅ 支持 | 在您的终端中进行AI配对编程 |
| ✨ 增强代码 | 手动配置 | ✅ 支持 | AI编码助手 |
| 🔗 任何MCP客户端 | 手动配置 | ✅ 支持 | 标准MCP协议 |
______________________________________________________________________
🏗️ 建筑
🛠️ 技术栈
- ⚡ 运行时：Node.js 18+
- 📘 语言：具有严格类型检查的TypeScript
- 🔌 MCP-SDK：@modelcontextprotocol/sdk v1.0.0+
- 🌐 HTTP客户端：Axios具有全面的错误处理功能
- ✅ 验证：所有API输入/输出的Zod模式
- 🔧 发展：ESLint、Prettier、Jest用于测试
📁 项目结构
├── src/
│ ├── index.ts # 🚀 Main entry point and CLI command handling
│ ├── server.ts # 🔌 MCP server implementation with all 19 tools
│ ├── client.ts # 🌐 LeadMagic API client wrapper
│ ├── types.ts # 📝 TypeScript types and Zod schemas
│ └── install.tsx # 🎨 The new interactive installer (React/Ink)
├── dist/ # 📦 Compiled JavaScript output
├── .env.example # 🔐 Environment configuration example
└── README.md # 📚 This file______________________________________________________________________
📊 api参考
🔤 字段命名约定
所有字段都使用snake_case （与LeadMagic API匹配）：
{
"first_name": "John",
"company_name": "Acme Corp",
"email_status": "valid"
}🔐 认证
在请求中包含您的API密钥：
X-API-Key: your-leadmagic-api-key⏱️ 速率限制
- 👤 个人资料搜索：300个请求/分钟
- 📊 其他端点：适用标准费率限制
❌ 错误处理
所有端点的错误格式一致：
{
"error": "Bad Request",
"message": "API key is missing or invalid."
}______________________________________________________________________
📈 信用消费
| 端点 | 积分 | 备注 |
|---|---|---|
💳 /credits | 0 | 可自由查看 |
✅ /email-validate | 0.05 | 非常划算 |
📧 /email-finder | 1 | 标准费率 |
📱 /mobile-finder | 5 | 只有找到 |
👤 /profile-search | 1 | 速率限制（300/min） |
🔗 /b2b-profile | 10 | 反向查找的成本更高 |
💰 /company-funding | 4 | 高级情报 |
💼 /jobs-finder | 每份工作1份 | 基于结果 |
🔍 /google/searchads | 每个广告1个 | 基于找到的广告 |
| 📊 所有其他 | 1-2 | 标准费率 |
______________________________________________________________________
🔒 安全与最佳实践
✅ 代码中没有API键 -始终使用环境变量\ ✅ 类型安全请求 -通过Zod验证全面覆盖TypeScript\ ✅ 错误处理 -全面的错误捕获和用户友好的消息\ ✅ 速率限制 -尊重LeadMagic API费率限制\ ✅ 安全默认值 -开箱即用的生产就绪配置\ ✅ 交互式安装程序 -无需手动编辑配置文件
______________________________________________________________________
🎯 安装矩阵
根据您的设置选择安装方法：
| 场景 | 命令 | 最适合 |
|---|---|---|
| 🆕 首次用户 | npx leadmagic-mcp-server install | 最简单的设置 |
| 🤖 克劳德桌面 | 交互式安装程序→ 选项1 | 最受欢迎 |
| 🎯 光标/VS代码 | 交互式安装程序→ 选项2/5 | 开发人员 |
| 🔄 多个客户端 | 交互式安装程序→ 选项7 | 高级用户 |
| ⚡ 快速测试 | LEADMAGIC_API_KEY=key npx leadmagic-mcp-server | 测试 |
| 💻 地方发展 | 克隆仓库+ .env 文件 | 贡献者 |
______________________________________________________________________
🤝 支持和资源
- 📚 API文档: docs.leadmagic.io
- 🌐 官方网站: leadmagic.io
- 📊 仪表盘: 应用程序.leadmagic.io
- 🆘 支持: support@leadmagic.io
- 🐛 问题:
- 💬 社区: 加入我们的Discord
- 🐙 源代码:
______________________________________________________________________
📄 许可证
MIT许可证-请参阅 许可证 文件以获取详细信息。
______________________________________________________________________
🙋♀️ 贡献
我们欢迎捐款！以下是如何开始：
- 🍴 分叉存储库
- 🌿 创建要素分支：
git checkout -b feature/new-feature - ✨ 进行更改并添加测试
- ✅ 运行验证：
npm run validate - 💾 提交您的更改：
git commit -am 'Add new feature' - 📤 推到分支：
git push origin feature/new-feature - 🔄 提交拉取请求
🐛 错误报告
发现bug了吗？请 打开一个问题 与：
- 📝 对问题的清晰描述
- 🔄 重现步骤
- 💻 您的环境详细信息
- 📋 预期行为与实际行为
💡 功能请求
有主意吗？ 请求功能 与：
- 📖 对功能的清晰描述
- 🎯 用例和好处
- 💭 任何实施想法
______________________________________________________________________
🔄 更新和更改日志
v1.0.1（最新）-2025年6月27日
- 🎨 重新设计的README，带有专业且有影响力的标题
- 📦 增强的package.json，具有更好的描述和关键字
- 🎯 改进品牌和视觉呈现
- 🔧 文档润色和术语一致性
- 🏷️ 添加了带有安全验证的增强徽章
- 📚 整体专业演示改进
v1.0.0-2025年6月27日
- ✨ 所有主要AI工具的交互式安装程序
- ✅ 支持Claude Desktop、Cursor、Windsurf、Continue.dev、VS Code、Zed
- 🔧 实现了所有19个LeadMagic API端点
- 🎯 配置npx使用率为零
- 🔒 增强的安全性和错误处理
- 📚 全面的文件
______________________________________________________________________
🎉 与 LeadMagic OpenAPI官方规范 API精度100%
______________________________________________________________________
🌟 在GitHub上为我们投票🐛 报告问题•💡 请求功能
由以下材料制成❤️ LeadMagic团队