返回 MCP 目录
public公开dns本地运行

email-checker-mcp

一个用于验证电子邮件地址是否存在的Python工具,无需API密钥,提供简单的JSON响应格式。

article

README

🚀 邮件检查 MCP 服务器

这个工具专为冷 Outreach 邮件设计,能帮助你轻松验证邮箱地址,确保邮件精准送达。

🚀 快速开始

此工具可助你高效验证邮箱地址,为冷 Outreach 邮件提供有力支持。

✨ 主要特性

  • 🔍 邮箱地址验证:精准验证邮箱地址的有效性。
  • 📄 简单的 JSON 响应格式:方便处理和解析。
  • 🗝️ 无需 API 密钥:使用起来更加便捷。

📦 安装指南

先决条件

  • 🐍 Python 3.x

安装步骤

  1. 克隆仓库:
git clone https://github.com/ravinahp/email-checker-mcp.git
cd email-checker-mcp
  1. 使用 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"
        ]
    }
}

⚠️ 重要提示

  1. YOUR_USERNAME 替换为你的实际系统用户名。
  2. 确保目录路径与你的本地安装一致。

💻 使用示例

基础用法

该服务提供了一个 FastMCP 工具用于验证邮箱地址:

@mcp.tool()
async def validate_email(email: str) -> bool:
    """验证一个邮箱地址是否存在。"""

示例用法

问题:这个邮件存在吗?

参数:

  • email: 包含要验证的邮箱地址的字符串

示例响应:

{
    "exist": true
}

📚 详细文档

API 使用限制

该服务使用了2IP的 Email API,提供以下功能:

  • 无需 API 密钥

错误处理

该服务包含以下错误处理功能:

  • 无效邮箱格式
  • API 请求失败
  • 网络超时
  • 速率限制
help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端