使用说明

项目简介

Email Client MCP Server 是一个基于 Model Context Protocol (MCP) 构建的后端应用，旨在为大型语言模型（LLM）应用提供邮件管理能力。通过此 MCP 服务器，LLM 应用可以安全、便捷地访问和操作用户的邮件功能，例如管理邮箱配置、发送邮件、检索邮件等。它充当 LLM 应用和邮件服务之间的桥梁，以标准化的方式提供邮件上下文和操作能力。

主要功能点

邮件配置管理：支持添加、更新、删除和列出邮件账户配置信息。
邮件发送：允许 LLM 应用通过配置好的邮件账户发送邮件。
邮件检索：
- 最新邮件获取：获取最新的未读邮件。
- 关键词搜索：根据关键词在邮件主题和正文中进行快速文本搜索。
- 日期范围搜索：检索特定日期范围内的邮件。
- 语义搜索：利用语义搜索技术，根据邮件内容的相关性进行高级搜索。
邮件统计：获取邮件数据库中邮件的总数。
邮件向量化：支持为邮件内容生成向量嵌入，为语义搜索提供技术支持。

安装步骤

克隆仓库

git clone https://github.com/gamalan/mcp-email-client.git
cd mcp-email-client

安装 uv 根据您的操作系统（Linux/MacOS 或 Windows），执行以下命令安装 'uv' 包管理器。

Linux/MacOS:

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

安装依赖 使用 'uv' 安装项目依赖：
```
uv sync
```

服务器配置

为了让 MCP 客户端（如 Claude Desktop）连接到 Email Client MCP Server，您需要在客户端中配置服务器启动命令及其参数。以下是 JSON 格式的服务器配置示例。请将 '/path/to/uv' 替换为 'uv' 的实际路径，'/path/to/repo' 替换为您克隆仓库的目录路径。

{
  "servers": {
    "email_mcp_server": {  // 服务器名称，可以自定义
      "type": "stdio",    // 连接类型，使用标准输入输出
      "command": "/path/to/uv", // uv 命令的路径，例如 /usr/local/bin/uv 或 C:\\Users\\YourUser\\.uv\\bin\\uv.exe
      "args": [          // uv 命令的参数列表
        "run",          // 运行 Python 脚本
        "--directory",  // 指定工作目录
        "/path/to/repo", // **[请替换为仓库的实际目录路径]**，例如 /Users/yourname/mcp-email-client 或 D:\\Project\\mcp-email-client
        "run_mcp_server.py" // 运行的服务器启动脚本
      ]
    }
  }
}

基本使用方法

启动服务器：在 MCP 客户端中配置好服务器信息后，启动 Email Client MCP Server。服务器将通过标准输入输出与客户端通信。
配置邮件账户：使用 MCP 客户端提供的界面或命令，调用 'add_email_config' 工具来添加邮件账户配置。您需要提供邮件服务器地址、端口、用户名、密码以及 SSL/TLS 设置等信息。
使用邮件功能：配置邮件账户后，即可使用其他工具如 'send_email' 发送邮件，'search_emails' 进行关键词搜索，'semantic_search_emails' 进行语义搜索，以及 'read_email' 获取最新邮件等。具体工具的使用方法请参考 MCP 客户端的文档或界面说明。

例如，在 Claude Desktop 中，您可以在 "Settings" -> "MCP Servers" 中添加上述 JSON 配置，并启动 "email_mcp_server"。之后，您就可以在 Claude 中使用 '@email_mcp_server' 命令来调用邮件相关的工具了。

关键词