yt-slack-mcp

MCP-Server für Slack — Permalinks, Threads und Channel-Verlauf lesen; auf Threads antworten; Reaktionen hinzufügen.

Implementiert die Spezifikation des Model Context Protocol: Es läuft über den stdio-Transport, spricht JSON-RPC 2.0, verhandelt die Protokollversion bei initialize, meldet tools-Fähigkeiten und beschreibt jedes Werkzeug mit einem JSON Schema. Die Aushandlung der Protokollversion wird von der Server-Klasse des @modelcontextprotocol/sdk übernommen, die standardmäßig die neueste unterstützte Version verwendet.

Werkzeuge

Lese-Werkzeuge verwenden die private Slack-Browser-Session-API (über xoxc- / xoxd-Tokens) und können so private Dateiinhalte abrufen — PDFs werden heruntergeladen und Text extrahiert (bis zu 50 Seiten / 100k Zeichen), Bilder werden inline zurückgegeben.

Related MCP server: Slack MCP Server

Einrichtung

1. Browser-Session-Tokens abrufen

• xoxc: localStorage-Token der Slack-Web-App (aus deiner angemeldeten Browser-Sitzung).

• xoxd: Slack-Cookie namens d.

Diese müssen möglicherweise aktualisiert werden, wenn Slack die Sitzung rotiert/ungültig macht.

2. Die Geheimnisse ablegen

Speichere jedes Token als einzeilige Datei:

~/.config/opencode/secrets/slack-xoxc.txt
~/.config/opencode/secrets/slack-xoxd.txt

Oder überschreibe die Pfade über die Konfigurationsdatei oder Umgebungsvariablen.

3. (Optional) Erlaubte Schreibkanäle und Pfade konfigurieren

Die gesamte Konfiguration kann in einer JSON-Konfigurationsdatei unter ~/.config/yt-slack-mcp/config.json liegen (überschreibbar mit SLACK_MCP_CONFIG):

{
  "secretsDir": "~/.config/opencode/secrets",
  "xoxcPath": "~/.config/opencode/secrets/slack-xoxc.txt",
  "xoxdPath": "~/.config/opencode/secrets/slack-xoxd.txt",
  "allowedWriteChannels": ["C0123456789", "C0987654321"],
  "userAgent": "Mozilla/5.0"
}

Standardmäßig sind die Schreib-Werkzeuge (slack_reply_to_thread, slack_add_reaction) gesperrt — kein Channel ist beschreibbar. Jedes Feld ist optional; eine fehlende Datei bedeutet lediglich Standardwerte. Umgebungsvariablen überschreiben immer die Konfigurationsdatei.

Konfiguration

Reihenfolge der Konfigurationsauflösung: eingebaute Standardwerte → Konfigurationsdatei → Umgebungsvariablen.

MCP-Host-Konfiguration

opencode

{
  "mcp": {
    "slack": {
      "type": "local",
      "command": ["npx", "yt-slack-mcp"]
    }
  }
}

Claude Desktop

{
  "mcpServers": {
    "slack": {
      "command": "npx",
      "args": ["yt-slack-mcp"]
    }
  }
}

Lizenz

MIT