STARWARCLOUD STARWAR.AI
返回市场
魔力引领-mcp

魔力引领-mcp

作者：LeadMagic5 星标更新：2025-06-27
安装使用来源：spider==github.com

项目介绍

🚀 LeadMagic MCP Server

<div align="center">

LeadMagic MCP Server

⚡ 针对B2B数据增强的终极模型上下文协议服务器

无缝集成LeadMagic全套API与Claude、Cursor、Windsurf及所有兼容MCP的人工智能工具

npm 版本 下载量 许可证: MIT Node.js

TypeScript MCP 兼容 生产就绪 安全

GitHub Stars GitHub Issues GitHub Forks 最近一次提交

🎯 19 强大工具 • 🔥 零配置 • ⚡ 一行设置 • 🛡 企业级安全

</div>

📖 目录

🎯 通过模型上下文协议访问LeadMagic的所有19个API端点，实现与Claude、Cursor、Windsurf、Continue.dev和其他兼容MCP的人工智能工具的无缝集成。

🚀 超简单安装

⚡ 选项1：交互式安装程序（推荐）

最简单的开始方式——适用于macOS、Windows和Linux。我们的新交互式安装程序，使用React和Ink构建，使设置变得轻松。

# 🔥 使用npx（无需安装）
npx leadmagic-mcp-server install

✨ 安装程序会：

  • ✅ 实时验证您的API密钥并显示剩余信用额度。
  • ✅ 自动检测并配置您首选的人工智能工具（如Claude、Cursor、VS Code等）。
  • ✅ 创建所有必要的配置文件和本地.env文件用于开发。
  • ✅ 提供使用示例和有用的链接。

📱 选项2：快速手动设置

如果您偏好手动设置或使用像Aider这样的客户端，您可以直接将服务器配置添加到客户端的设置文件中。交互式安装程序提供了可以复制粘贴的片段。

运行安装程序并选择“其他（手动设置）”选项：

npx leadmagic-mcp-server install

🔑 获取您的API密钥

  1. 🌐 访问 LeadMagic仪表板
  2. 📝 注册免费账户（如有需要）
  3. 🔐 生成您的API密钥
  4. 📋 在提示时将其粘贴到交互式安装程序中。

⚡ npx使用（零安装）

您可以在不安装的情况下使用服务器，这非常适合快速测试或容器化环境：

# 🚀 直接运行并带上您的API密钥
LEADMAGIC_API_KEY=your-key npx leadmagic-mcp-server

# 📋 运行交互式安装程序
npx leadmagic-mcp-server install

# ❓ 查看可用命令
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个人资料网址
  • 💰 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 - 按公司搜索Google广告
  • 📘 search_meta_ads - 搜索Meta（Facebook/Instagram）广告
  • 📈 search_b2b_ads - 搜索B2B广告活动
  • 📄 get_b2b_ad_details - 获取详细的B2B广告信息

💡 使用示例

安装后，您可以在人工智能工具中使用自然语言命令：

📧 电子邮件操作

"查找Microsoft的John Doe的电子邮件"
"验证电子邮件john@acme.com"
"从B2B个人资料https://linkedin.com/in/johndoe查找个人电子邮件"

🏢 公司情报

"搜索特斯拉公司信息"
"获取Stripe的资金信息"
"查找OpenAI从事工程工作的员工"

💼 工作与招聘

"查找科技公司的软件工程师职位"
"在旧金山搜索产品经理职位"
"查找此B2B个人资料的移动电话号码"

📱 竞争分析

"搜索来自competitor.com的Google广告"
"查找公司XYZ的Meta广告"
"获取stripe.com的B2B广告活动"

🔧 开发环境设置

📋 前提条件

  • 📦 Node.js 18.0.0或更高版本
  • 🔑 来自 leadmagic.io 的LeadMagic API密钥

💻 本地开发

# 📥 克隆仓库
git clone https://github.com/LeadMagic/leadmagic-mcp.git
cd leadmagic-mcp

# 📦 安装依赖
npm install

# 🔐 创建环境文件
echo "LEADMAGIC_API_KEY=your-api-key-here" > .env

# 🚀 启动开发服务器
npm run dev

# 🏗️ 构建生产环境
npm run build

# ✅ 运行验证
npm run validate

🔍 使用MCP Inspector进行测试

# 🚀 启动MCP Inspector
npm run inspector

# 🌐 在浏览器中打开提供的URL以测试所有工具

🌐 支持的MCP客户端

客户端安装状态备注
🤖 Claude Desktop交互式安装程序或手动配置✅ 完全支持官方Anthropic客户端
🎯 Cursor (Cline)交互式安装程序或VS Code设置✅ 完全支持需要Cline扩展
🏄 Windsurf交互式安装程序或手动配置✅ 完全支持Codeium的AI IDE
🔄 Continue.dev交互式安装程序或配置文件✅ 完全支持开源编码助手
💻 VS Code (Cline)VS Code settings.json✅ 完全支持需要Cline扩展
💻 VS Code (Continue)Continue扩展配置✅ 完全支持需要Continue扩展
⚡ Zed Editor交互式安装程序或设置✅ 完全支持现代代码编辑器
🤖 Aider手动配置✅ 支持终端中的AI配对编程
✨ Augment Code手动配置✅ 支持AI编码助手
🔗 任何MCP客户端手动配置✅ 支持标准MCP协议

🏗️ 架构

🛠️ 技术栈

  • ⚡ 运行时：Node.js 18+
  • 📘 语言：带有严格类型检查的TypeScript
  • 🔌 MCP SDK：@modelcontextprotocol/sdk v1.0.0+
  • 🌐 HTTP客户端：Axios，具有全面的错误处理
  • ✅ 验证：Zod模式用于所有API输入/输出
  • 🔧 开发：ESLint、Prettier、Jest用于测试

📁 项目结构

├── src/
│   ├── index.ts        # 🚀 主入口点和CLI命令处理
│   ├── server.ts       # 🔌 包含所有19个工具的MCP服务器实现
│   ├── client.ts       # 🌐 LeadMagic API客户端包装器
│   ├── types.ts        # 📝 TypeScript类型和Zod模式
│   └── install.tsx     # 🎨 新的交互式安装程序（React/Ink）
├── dist/               # 📦 编译后的JavaScript输出
├── .env.example        # 🔐 环境配置示例
└── README.md           # 📚 此文件

📊 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密钥丢失或无效。"
}

📈 信用消耗

端点信用备注
💳 /credits0免费检查
✅ /email-validate0.05非常经济
📧 /email-finder1标准费率
📱 /mobile-finder5仅在找到时
👤 /profile-search1速率限制（每分钟300次）
🔗 /b2b-profile10反向查找成本较高
💰 /company-funding4高级情报
💼 /jobs-finder每个职位1基于结果
🔍 /google/searchads每个广告1基于找到的广告
📊 其他1-2标准费率

🔒 安全与最佳实践

✅ 不在代码中包含API密钥 - 始终使用环境变量
✅ 类型安全请求 - 全面的TypeScript覆盖和Zod验证
✅ 错误处理 - 全面的错误捕获和用户友好的消息
✅ 速率限制 - 尊重LeadMagic API的速率限制
✅ 安全默认值 - 出厂即生产就绪配置
✅ 交互式安装程序 - 不需要手动编辑配置文件

🎯 安装矩阵

根据您的设置选择安装方法：

场景命令最适合
🆕 首次用户npx leadmagic-mcp-server install最简单的设置
🤖 Claude Desktop交互式安装程序 → 选项1最受欢迎
🎯 Cursor/VS Code交互式安装程序 → 选项2/5开发者
🔄 多个客户端交互式安装程序 → 选项7功力用户
⚡ 快速测试LEADMAGIC_API_KEY=key npx leadmagic-mcp-server测试
💻 本地开发克隆仓库 + .env 文件贡献者

🤝 支持与资源

📄 许可证

MIT许可证 - 详见LICENSE文件。

🙋‍♀️ 贡献

我们欢迎贡献！以下是开始的方法：

  1. 🍴 分叉仓库
  2. 🌿 创建一个功能分支：git checkout -b feature/new-feature
  3. ✨ 进行更改并添加测试
  4. ✅ 运行验证：npm run validate
  5. 💾 提交更改：git commit -am '添加新功能'
  6. 📤 推送到分支：git push origin feature/new-feature
  7. 🔄 提交拉取请求

🐛 报告错误

发现错误？请打开一个问题并提供：

  • 📝 清晰的问题描述
  • 🔄 复现步骤
  • 💻 您的环境细节
  • 📋 预期行为与实际行为

💡 功能请求

有想法？[请求一个功能](https://github.com/LeadMagic/leadmagic-mcp/issues/new?assignees=&labels=enh