mcp_email_reader

🚀 mcp_email_reader

模型上下文协议（MCP）服务器公开了多个mcp工具，如 search_emails、download_attachment 和 list_folders。该项目已在Claude Desktop和LibreChat上结合Ollama完成测试。

🚀 快速开始

模型上下文协议（MCP）服务器提供了诸如 search_emails、download_attachment 和 list_folders 等工具。这些工具可在Claude Desktop和LibreChat上结合Ollama使用，为用户带来便利。

📦 安装指南

先决条件

Windows

1. 安装Claude Desktop（或其他支持MCP的AI工具）
   • 点击Claude for Desktop 进行下载。
   • 按照在Windows上安装Claude Desktop 的说明完成安装。
2. 安装Python 3.10或更高版本
   • 从 python.org 下载最新版Python安装程序。
   • 运行安装程序，选择“将Python添加到PATH”。
   • 打开命令提示符，使用 python --version 验证安装是否成功。
3. 安装uv
   • 以管理员身份打开命令提示符。
   • 运行 pip install --user uv。
   • 使用 uv --version 验证安装。

macOS

1. 安装Claude Desktop（或其他支持MCP的AI工具）
   • 下载Claude for Desktop。
   • 按照在macOS上安装Claude Desktop 的说明进行安装。
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_ACCOUNT": "<用户电子邮件账户>",
                "EMAIL_PASSWORD_ENC": "<加密密码>",
                "EMAIL_SECRET_KEY": "<用于加密密码的密钥>"
            }
        }
    }
}

⚠️ 重要提示

显然，秘密密钥可以用来解密加密的密码，因此存在潜在的安全风险——尽管 claude_desktop_config.json 文件存储在你的笔记本电脑/PC上。由于使用 uvx 动态克隆仓库时无法添加 .env 文件，所以将其添加到json文件中。

📄 许可证

此软件包实现了将电子邮件读入MCP启用框架的功能，并由karateboss开发。

✨ 主要特性

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

💻 使用示例

问题反馈与支持

对于问题和支持，你可以：

1. 检查我们的文档。
2. 在我们的仓库中提交一个问题。