yt-slack-mcp

MCP-сервер для Slack — чтение пермалинков, тредов и истории каналов; ответы в тредах; добавление реакций.

Реализует спецификацию Model Context Protocol: работает через stdio-транспорт, использует JSON-RPC 2.0, согласует версию протокола при initialize, анонсирует возможности tools и описывает каждый инструмент с помощью JSON Schema. Согласование версии протокола обрабатывается классом Server из @modelcontextprotocol/sdk, который по умолчанию использует последнюю поддерживаемую версию.

Инструменты

Инструменты чтения используют приватный API браузерной сессии Slack (через токены xoxc / xoxd), поэтому они могут получать содержимое приватных файлов — PDF-файлы загружаются, и из них извлекается текст (до 50 страниц / 100 000 символов), изображения возвращаются прямо в ответе.

Related MCP server: Slack MCP Server

Настройка

1. Получите токены браузерной сессии

• xoxc: токен localStorage веб-версии Slack (из вашей браузерной сессии).

• xoxd: cookie Slack с именем d.

Возможно, их потребуется обновлять, когда Slack ротирует или аннулирует сессию.

2. Разместите секреты

Сохраните каждый токен в отдельном файле в одну строку:

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

Или переопределите пути через конфигурационный файл или переменные окружения.

3. (Необязательно) Настройте разрешённые каналы для записи и пути

Вся конфигурация может находиться в JSON-файле по пути ~/.config/yt-slack-mcp/config.json (переопределяется с помощью 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"
}

По умолчанию инструменты записи (slack_reply_to_thread, slack_add_reaction) заблокированы — ни один канал не доступен для записи. Все поля необязательны; отсутствие файла просто означает значения по умолчанию. Переменные окружения всегда имеют приоритет над конфигурационным файлом.

Конфигурация

Порядок разрешения конфигурации: встроенные значения по умолчанию → конфигурационный файл → переменные окружения.

Конфигурация MCP-хоста

opencode

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

Claude Desktop

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

Лицензия

MIT