article
README
🚀 邮件检查 MCP 服务器
这个工具专为冷 Outreach 邮件设计,能帮助你轻松验证邮箱地址,确保邮件精准送达。
🚀 快速开始
此工具可助你高效验证邮箱地址,为冷 Outreach 邮件提供有力支持。
✨ 主要特性
- 🔍 邮箱地址验证:精准验证邮箱地址的有效性。
- 📄 简单的 JSON 响应格式:方便处理和解析。
- 🗝️ 无需 API 密钥:使用起来更加便捷。
📦 安装指南
先决条件
- 🐍 Python 3.x
安装步骤
- 克隆仓库:
git clone https://github.com/ravinahp/email-checker-mcp.git
cd email-checker-mcp
- 使用 uv 安装依赖项:
uv sync
⚠️ 重要提示
我们使用
uv而不是pip,因为项目使用pyproject.toml进行依赖管理。
🛠️ 配置为 MCP 服务器
要将此工具添加为 MCP 服务器,你需要修改你的Claude桌面配置文件。配置文件的位置取决于你的操作系统:
- MacOS:
~/Library/Application\ Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%/Claude/claude_desktop_config.json
在 JSON 文件中添加以下配置:
{
"email-checker-mcp": {
"command": "uv",
"args": [
"--directory",
"/Users/YOUR_USERNAME/Code/email-checker-mcp",
"run",
"email-checker-mcp"
]
}
}
⚠️ 重要提示
- 将
YOUR_USERNAME替换为你的实际系统用户名。- 确保目录路径与你的本地安装一致。
💻 使用示例
基础用法
该服务提供了一个 FastMCP 工具用于验证邮箱地址:
@mcp.tool()
async def validate_email(email: str) -> bool:
"""验证一个邮箱地址是否存在。"""
示例用法
问题:这个邮件存在吗?
参数:
email: 包含要验证的邮箱地址的字符串
示例响应:
{
"exist": true
}
📚 详细文档
API 使用限制
该服务使用了2IP的 Email API,提供以下功能:
- 无需 API 密钥
错误处理
该服务包含以下错误处理功能:
- 无效邮箱格式
- API 请求失败
- 网络超时
- 速率限制
微信扫一扫