Yahoo Mail MCP-Server

Ein Model Context Protocol (MCP)-Server, der es LLMs ermöglicht, mit Yahoo Mail zu interagieren. Dieser Server erlaubt es Tools wie Claude Desktop, E-Mails direkt über Ihr Yahoo-Konto mittels sicherer OAuth2-Authentifizierung zu lesen, zu suchen und zu senden.

Funktionen (Geplant)

• E-Mails lesen: Abrufen aktueller Nachrichten aus Ihrem Posteingang.

• E-Mails suchen: Suche nach bestimmten Nachrichten anhand von Schlüsselwörtern, Absendern oder Daten.

• E-Mails senden: Verfassen und Senden von E-Mails über die SMTP-Server von Yahoo.

Voraussetzungen

• Node.js: Version 20 oder höher.

• Yahoo Developer App: Sie müssen eine App im Yahoo Developer Portal erstellen, um OAuth2-Anmeldedaten zu erhalten.

Erstellen einer Yahoo-App für OAuth2

1. Gehen Sie zum Yahoo Developer Portal.

2. Erstellen Sie eine neue App.

3. Setzen Sie die API-Berechtigungen auf Mail (Lesen und Schreiben).

4. Setzen Sie den Redirect URI auf https://localhost/callback (oder Ihren bevorzugten URI).

5. Notieren Sie sich Ihre Client ID und Ihr Client Secret.

Einrichtung

1. Repository klonen:

   git clone <repository-url>
   cd yahoo-mail-mcp

2. Abhängigkeiten installieren:

   npm install

3. Umgebungsvariablen konfigurieren: Erstellen Sie eine .env-Datei im Stammverzeichnis und fügen Sie Ihre Yahoo-Anmeldedaten hinzu:

   YAHOO_EMAIL=your-email@yahoo.com
   YAHOO_CLIENT_ID=your-client-id
   YAHOO_CLIENT_SECRET=your-client-secret
   YAHOO_REDIRECT_URI=https://localhost/callback

Authentifizierung

Beim ersten Start des Servers wird ein OAuth2-Ablauf ausgelöst:

1. Ein Browserfenster öffnet sich und fordert Sie auf, sich bei Yahoo anzumelden.

2. Nach der Autorisierung werden Sie zu Ihrem REDIRECT_URI weitergeleitet.

3. Die Seite lädt möglicherweise nicht, aber das ist in Ordnung – kopieren Sie den code-Parameter aus der Adressleiste.

4. Fügen Sie den Code in Ihr Terminal ein.

5. Der Server tauscht den Code gegen Token aus und speichert diese sicher in .tokens.json.

Verwendung

Entwicklung

Um den Server im Entwicklungsmodus mit vite-node auszuführen:

npm run dev

Build

Um das Projekt für die Produktion zu bauen:

npm run build

Integration mit Claude Desktop

Um diesen Server mit Claude Desktop zu verwenden, fügen Sie ihn Ihrer claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "yahoo-mail": {
      "command": "node",
      "args": ["/path/to/yahoo-mail-mcp/dist/index.js"]
    }
  }
}

Projektstruktur

• src/index.ts: Einstiegspunkt für den MCP-Server.

• src/server.ts: MCP-Server-Initialisierung und Tool-Registrierung.

• src/auth/: OAuth2-Ablauf und Token-Verwaltung.

• src/tools/: Implementierung der einzelnen E-Mail-Tools.

• src/lib/: Hilfsbibliotheken für IMAP- und SMTP-Verbindungen.

Lizenz

ISC