mcpField
M
mcp_email_reader

mcp_email_reader

本地服务
github.com/karateboss通信协作169 周前更新
代码仓库

关于 mcp_email_reader

mcp_email_reader 是供兼容 AI 工具读取邮件的 MCP 服务，提供邮件搜索、附件下载和文件夹列表工具。

主要功能

  1. 01搜索邮件
  2. 02下载附件
  3. 03列出文件夹

适用场景

  1. 01按条件查找邮件
  2. 02获取邮件附件
  3. 03查看可用邮件文件夹

MCP 相关

向 MCP 客户端提供邮件搜索、附件下载和文件夹列表工具。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "mcp_email_reader": {
      "command": "uvx",
      "args": [
        "git+https://github.com/karateboss/mcp_email_reader@main"
      ],
      "env": {
        "IMAP_SERVER": "<IMAP_SERVER>",
        "EMAIL_ACCOUNT": "<EMAIL_ACCOUNT>",
        "EMAIL_PASSWORD_ENC": "<EMAIL_PASSWORD_ENC>",
        "EMAIL_SECRET_KEY": "<EMAIL_SECRET_KEY>"
      }
    }
  }
}
启动命令uvx 'git+https://github.com/karateboss/mcp_email_reader@main'
需要配置的环境变量
IMAP_SERVER
EMAIL_ACCOUNT
EMAIL_PASSWORD_ENC密钥
EMAIL_SECRET_KEY密钥

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
pypigit+https://github.com/karateboss/mcp_email_reader@main

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

mcp_email_reader

模型上下文协议（MCP）服务提供了多个 MCP 工具，分别为 search_emails、download_attachment 和 list_folders。已在 Claude Desktop 和使用 Ollama 的 LibreChat 上进行测试。

安装

前置条件
Windows

  1. 安装 Claude Desktop（或其他支持 MCP 的 AI 工具）

  2. 安装 Python 3.10 或更高版本：

    • 从 python.org 下载最新的 Python 安装程序
    • 运行安装程序，并勾选“Add Python to PATH”
    • 打开命令提示符，使用 python --version 验证安装

  3. 安装 uv：

    • 以管理员身份打开命令提示符
    • 运行 pip install --user uv
    • 使用 uv --version 验证安装
macOS

  1. 安装 Claude Desktop（或其他支持 MCP 的 AI 工具）

  2. 安装 Python 3.10 或更高版本：

    • 使用 Homebrew：brew install python
    • 使用 python3 --version 验证安装

  3. 安装 uv：

    • 使用 Homebrew：brew install uv
    • 或者：pip3 install --user uv
    • 使用 uv --version 验证安装

配置

将以下内容添加到你的 claude_desktop_config.json 中：

{
    "mcpServers": {
        "mcp_email_reader": {
            "command": "uvx",
            "args": [
                "--from",
                "git+https://github.com/karateboss/mcp_email_reader@main",
                "mcp_email_reader"
            ],
        "env": {
            "IMAP_SERVER": "<email server>",
            "EMAIL_ACCOUNT": "<user email account>",
            "EMAIL_PASSWORD_ENC": "<encrypted password>"
            "EMAIL_SECRET_KEY": "<secret key used to encypt password>"
        }
    }
}

注意：显然，密钥可用于解密加密后的密码，因此存在潜在的安全风险，不过 claude_desktop_config.json 存储在你的笔记本电脑或 PC 本地。由于使用 uvx 动态克隆代码库时无法添加 .env 文件，因此已将其添加到上面的 json 文件中。

鸣谢

此软件包实现了在支持 MCP 的框架中读取电子邮件的功能，由 karateboss 开发。

参与贡献

欢迎为改进这些工具贡献力量。请通过我们的代码库提交问题和拉取请求。

支持

如有疑问或需要支持：

  1. 查看我们的文档
  2. 在我们的代码库中提交问题

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。