Warpcast MCP Server

Warpcast MCP-Server

Ein Model Context Protocol (MCP)-Server für die Warpcast-Integration, der es Ihnen ermöglicht, Claude zur Interaktion mit Ihrem Warpcast-Konto zu verwenden.
Die Implementierung folgt jetzt dem FastMCP -Stilserver aus dem MCP Python SDK.

Merkmale

• Veröffentlichen Sie Casts auf Ihrem Warpcast-Konto
• Casts von Warpcast lesen
• Suche nach Besetzungen nach Stichwort oder Hashtag
• Durchsuchen und interagieren Sie mit Kanälen
• Kanälen folgen/nicht mehr folgen
• Holen Sie sich trendige Casts

Warpcast-API https://docs.farcaster.xyz/reference/warpcast/api

Verwendung

mcp-warpcast-server wird normalerweise automatisch vom MCP-Client von Claude Desktop gestartet, sobald die Warpcast-Tools konfiguriert sind. Nach dem Serverstart können Sie Claude Folgendes befehlen:

• „Poste einen Cast zu [Thema]“
• „Lesen Sie die neuesten Casts von [Benutzername]“
• „Suche nach Casts zum Thema [Thema]“
• „Zeig mir die angesagtesten Casts auf Warpcast“
• „Zeig mir beliebte Kanäle auf Warpcast“
• „Holen Sie sich Casts vom Kanal [Kanal]“
• „Folge dem Kanal [Kanal] für mich“

Verfügbare Tools

Dieser MCP-Server bietet mehrere Tools, die Claude verwenden kann:

1. Postcast : Erstellen Sie einen neuen Beitrag auf Warpcast (max. 320 Zeichen)
2. get-user-casts : Ruft die letzten Casts eines bestimmten Benutzers ab
3. search-casts : Suche nach Casts nach Stichwort oder Ausdruck
4. get-trending-casts : Holen Sie sich die aktuell angesagtesten Casts auf Warpcast
5. get-all-channels : Liste der verfügbaren Kanäle auf Warpcast
6. get-channel : Informationen zu einem bestimmten Kanal abrufen
7. get-channel-casts : Ruft Casts von einem bestimmten Kanal ab
8. follow-channel : Einem Kanal folgen
9. unfollow-channel : Einem Kanal nicht mehr folgen

Aufstellen

Claude Desktop startet diesen Server normalerweise automatisch, wenn die Warpcast-Tools konfiguriert sind. Die folgenden Schritte sind nur erforderlich, wenn Sie den Server für die Entwicklung manuell ausführen möchten.

1. Erstellen Sie eine virtuelle Python-Umgebung (Python 3.11 oder neuer wird empfohlen):
   python3 -m venv venv source venv/bin/activate
2. Installieren Sie Abhängigkeiten (zu den Anforderungen gehört das MCP Python SDK):
   pip install -r requirements.txt
3. Geben Sie ein Warpcast-API-Token an:
   • Melden Sie sich bei Warpcast an und öffnen Sie Einstellungen > Entwickler .
   • Klicken Sie auf „API-Token erstellen“ und kopieren Sie den Wert.
   • Fügen Sie WARPCAST_API_TOKEN im Abschnitt env Ihrer Claude-Desktopkonfiguration hinzu.
   • Wenn Sie den Server manuell starten, können Sie das Token stattdessen in Ihrer Shell exportieren:GXP3 Der Server validiert diese Variable beim Start. Fehlt sie, wird eine Warnung protokolliert und autorisierte Anfragen reagieren mit HTTP 500- Fehlern.
4. (Optional) Starten Sie den Server manuell: Die aus main.py exportierte app Variable wird mit mcp.streamable_http_app() erstellt, sodass sie von jedem ASGI-Server bereitgestellt werden kann.
   uvicorn main:app --reload

Der Server stellt HTTP-Endpunkte bereit, die den oben aufgeführten Tools entsprechen, sowie einen von FastMCP bereitgestellten Standard- /mcp -Endpunkt.

Verwendung mit Claude Desktop

Befolgen Sie diese Schritte, um über Claudes Desktopanwendung auf die Warpcast-Tools zuzugreifen:

1. Starten Sie den Server (oder lassen Sie ihn von Claude starten) gemäß den obigen Einrichtungsanweisungen.
2. Öffnen Sie Ihre Claude-Konfigurationsdatei:
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
3. Fügen Sie den Warpcast-Server unter dem Schlüssel mcpServers hinzu. Ersetzen Sie den Pfad durch den Speicherort dieses Repositorys:

Durch die Angabe einer url kommuniziert Claude Desktop mit dem Server über HTTP und verwendet dabei Server-Sent Events anstelle der Standard-Ein- und -Ausgabe. Wenn Sie url weglassen, kommuniziert Claude Desktop standardmäßig über die Standard-Ein- und -Ausgabe (stdio). Dies funktioniert mit diesem Server nicht.

4. Speichern Sie die Datei und starten Sie Claude Desktop neu. In der Chat-Eingabe sollte nun ein Hammersymbol angezeigt werden, mit dem Sie die Warpcast-Tools verwenden können.

Ausführen von Tests

Unit-Tests werden mit pytest geschrieben und verwenden TestClient von FastAPI (installiert über fastapi[testclient] ). Erstellen Sie eine virtuelle Umgebung, installieren Sie Abhängigkeiten und führen Sie die Suite aus:

Die Tests simulieren die Warpcast-API-Schicht, sodass keine Netzwerkverbindung erforderlich ist.

MCP-Kompatibilität

Dieser Server verwendet das offizielle MCP Python SDK und ist vollständig mit dem Model Context Protocol kompatibel. Clients können sich mit dem von FastMCP bereitgestellten /mcp -Endpunkt verbinden und mit den hier definierten Tools interagieren.

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert.