Slack MCP Server

Slack MCP-Server

Ein Model Context Protocol (MCP)-Server, der KI-Assistenten die Interaktion mit Slack-Arbeitsbereichen ermöglicht. Dieser Server bietet Tools zum Lesen und Posten von Nachrichten, Verwalten von Kanälen und mehr über die Slack-API.

Merkmale

• Kanalverwaltung : Kanäle auflisten, Kanalinformationen abrufen, Kanäle erstellen
• Nachrichtenvorgänge : Nachrichten senden, Nachrichtenverlauf lesen, auf Threads antworten
• Benutzerverwaltung : Benutzerinformationen abrufen, Arbeitsbereichsmitglieder auflisten
• Dateivorgänge : Dateien hochladen, Dateien in Kanälen teilen
• Suche : Durchsuchen Sie den gesamten Arbeitsbereich nach Nachrichten und Dateien
• Reaktionen : Emoji-Reaktionen zu Nachrichten hinzufügen und entfernen

Voraussetzungen

• Python 3.8 oder höher
• Ein Slack-Arbeitsbereich mit Administratorberechtigungen
• Slack Bot Token mit entsprechenden Bereichen

Installation

1. Klonen Sie dieses Repository:

2. Installieren Sie Abhängigkeiten:

3. Richten Sie Ihr Slack Bot-Token ein (siehe Abschnitt „Konfiguration“ weiter unten)

Konfiguration

Einrichten des Slack Bot Token

1. Gehen Sie zur Slack-API und erstellen Sie eine neue App
2. Navigieren Sie in der Seitenleiste zu „OAuth & Berechtigungen“
3. Fügen Sie die folgenden Bot-Token-Bereiche hinzu:
   • channels:read – Grundlegende Informationen zu öffentlichen Kanälen anzeigen
   • channels:write – Öffentliche Kanäle verwalten
   • chat:write - Nachrichten als Bot senden
   • chat:write.public – Senden Sie Nachrichten an Kanäle, bei denen der Bot kein Mitglied ist
   • files:read – In Kanälen und Konversationen freigegebene Dateien anzeigen
   • files:write - Dateien hochladen, bearbeiten und löschen
   • groups:read – Grundlegende Informationen zu privaten Kanälen anzeigen
   • im:read - Grundlegende Informationen zu Direktnachrichten anzeigen
   • mpim:read - Grundlegende Informationen zu Gruppen-Direktnachrichten anzeigen
   • reactions:read - Emoji-Reaktionen und die zugehörigen Inhalte anzeigen
   • reactions:write – Emoji-Reaktionen hinzufügen und bearbeiten
   • search:read - Nachrichten und Dateien durchsuchen
   • users:read – Personen im Arbeitsbereich anzeigen
   • channels:history – Nachrichten und andere Inhalte in öffentlichen Kanälen anzeigen
   • groups:history – Nachrichten und andere Inhalte in privaten Kanälen anzeigen
   • im:history – Nachrichten und andere Inhalte in Direktnachrichten anzeigen
   • mpim:history - Nachrichten und andere Inhalte in Gruppen-Direktnachrichten anzeigen
4. Installieren Sie die App in Ihrem Arbeitsbereich
5. Kopieren Sie das „Bot User OAuth Token“ (beginnt mit xoxb- )

Umgebungsvariablen

Legen Sie Ihr Slack Bot Token als Umgebungsvariable fest:

Oder erstellen Sie eine .env Datei im Projektstammverzeichnis:

Verwendung

Ausführen des Servers

Der Server wird gestartet und wartet über stdio auf MCP-Verbindungen.

Verwendung mit Claude Desktop

Fügen Sie Ihrer Claude Desktop-Konfigurationsdatei die folgende Konfiguration hinzu:

Verfügbare Tools

Der Server stellt die folgenden Tools bereit:

Kanalbetrieb

• list_channels() – Listet alle Kanäle im Arbeitsbereich auf
• get_channel_info(channel_id) – Detaillierte Informationen zu einem Kanal abrufen
• create_channel(name, is_private=False) – Einen neuen Kanal erstellen

Nachrichtenvorgänge

• send_message(channel, text, thread_ts=None) – Senden Sie eine Nachricht an einen Kanal
• get_channel_history(channel, limit=10) – Aktuelle Nachrichten aus einem Kanal abrufen
• search_messages(query, count=20) - Suche nach Nachrichten im gesamten Arbeitsbereich

Benutzervorgänge

• get_user_info(user_id) – Informationen über einen Benutzer abrufen
• list_users() – Listet alle Benutzer im Arbeitsbereich auf

Dateioperationen

• upload_file(channels, content, filename, title=None) – Laden Sie eine Datei in die Kanäle hoch
• search_files(query, count=20) - Suche nach Dateien im Arbeitsbereich

Reaktionsvorgänge

• add_reaction(channel, timestamp, name) – Fügen Sie einer Nachricht eine Emoji-Reaktion hinzu
• remove_reaction(channel, timestamp, name) – Entfernen Sie eine Emoji-Reaktion aus einer Nachricht

Beispiele

Senden einer Nachricht

Kanalverlauf abrufen

Nachrichten suchen

Erstellen eines Kanals

Fehlerbehandlung

Der Server beinhaltet eine umfassende Fehlerbehandlung für:

• Ungültige Slack-Token
• Ratenbegrenzung
• Probleme mit der Netzwerkkonnektivität
• Ungültige Kanal-/Benutzer-IDs
• Berechtigungsfehler

Sicherheitsüberlegungen

• Bewahren Sie Ihr Slack Bot Token sicher auf und übergeben Sie es niemals der Versionskontrolle
• Verwenden Sie Umgebungsvariablen oder eine sichere Geheimnisverwaltung
• Wechseln Sie regelmäßig Ihre Bot-Token
• Überwachen Sie die Bot-Aktivität in Ihrem Slack-Arbeitsbereich
• Erteilen Sie nur die minimal erforderlichen Berechtigungen

Beitragen

1. Forken Sie das Repository
2. Erstellen eines Feature-Zweigs
3. Nehmen Sie Ihre Änderungen vor
4. Fügen Sie gegebenenfalls Tests hinzu
5. Senden einer Pull-Anfrage

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert – Einzelheiten finden Sie in der Datei LICENSE.

Unterstützung

Bei Problemen und Fragen:

1. Überprüfen Sie die Slack-API-Dokumentation
2. Überprüfen Sie die MCP-Spezifikation
3. Öffnen Sie ein Problem in diesem Repository