MCP Email Reader

🚀 mcp_email_reader

模型上下文協議（MCP）服務器公開了多個mcp工具，如search_emails、download_attachment和list_folders等。該項目已在Claude Desktop和LibreChat上結合Ollama進行了測試。

🚀 快速開始

本項目主要提供了模型上下文協議（MCP）相關工具，可用於搜索郵件、下載附件和列出文件夾等操作，適用於Claude Desktop和LibreChat等應用場景。

📦 安裝指南

先決條件

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. 在我們的倉庫中提交一個問題。