Slack MCP Server

Сервер Slack MCP

Сервер Model Context Protocol (MCP), который позволяет помощникам ИИ взаимодействовать с рабочими пространствами Slack. Этот сервер предоставляет инструменты для чтения сообщений, публикации сообщений, управления каналами и многого другого через API Slack.

Функции

• Управление каналами : список каналов, получение информации о канале, создание каналов
• Операции с сообщениями : отправка сообщений, чтение истории сообщений, ответ на темы
• Управление пользователями : получение информации о пользователях, список участников рабочего пространства
• Операции с файлами : загрузка файлов, обмен файлами в каналах
• Поиск : Поиск сообщений и файлов по всему рабочему пространству.
• Реакции : добавление и удаление эмодзи-реакций к сообщениям.

Предпосылки

• Python 3.8 или выше
• Рабочее пространство Slack с правами администратора
• Токен Slack Bot с соответствующими областями действия

Установка

1. Клонируйте этот репозиторий:

2. Установить зависимости:

3. Настройте токен бота Slack (см. раздел «Конфигурация» ниже)

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

Настройка токена бота Slack

1. Перейдите в Slack API и создайте новое приложение.
2. Перейдите в раздел «OAuth и разрешения» на боковой панели.
3. Добавьте следующие области действия токенов бота:
   • channels:read - Просмотр основной информации о публичных каналах
   • channels:write - Управление публичными каналами
   • chat:write - отправлять сообщения как бот
   • chat:write.public — отправлять сообщения в каналы, в которых бот не состоит
   • files:read - Просмотр файлов, которыми поделились в каналах и беседах
   • files:write — загрузка, редактирование и удаление файлов
   • groups:read - Просмотр основной информации о частных каналах
   • im:read - Просмотр основной информации о прямых сообщениях
   • mpim:read — просмотр основной информации о групповых прямых сообщениях
   • reactions:read - Просмотр реакций эмодзи и связанного с ними контента
   • reactions:write - Добавляйте и редактируйте эмодзи-реакции
   • search:read - Поиск сообщений и файлов
   • users:read - Просмотр людей в рабочей области
   • channels:history — просмотр сообщений и другого контента в публичных каналах
   • groups:history — Просмотр сообщений и другого контента в приватных каналах
   • im:history - Просмотр сообщений и другого контента в личных сообщениях
   • mpim:history — просмотр сообщений и другого контента в личных сообщениях группы
4. Установите приложение на свое рабочее место
5. Скопируйте «Токен OAuth пользователя бота» (начинается с xoxb- )

Переменные среды

Установите токен бота Slack в качестве переменной среды:

Или создайте файл .env в корне проекта:

Использование

Запуск сервера

Сервер запустится и будет прослушивать соединения MCP через stdio.

Использование с Claude Desktop

Добавьте следующую конфигурацию в файл конфигурации Claude Desktop:

Доступные инструменты

Сервер предоставляет следующие инструменты:

Операции канала

• list_channels() — список всех каналов в рабочей области
• get_channel_info(channel_id) - Получить подробную информацию о канале
• create_channel(name, is_private=False) — Создать новый канал

Операции с сообщениями

• send_message(channel, text, thread_ts=None) — отправить сообщение в канал
• get_channel_history(channel, limit=10) — Получить последние сообщения с канала
• search_messages(query, count=20) — Поиск сообщений в рабочей области

Операции пользователя

• get_user_info(user_id) - Получить информацию о пользователе
• list_users() — список всех пользователей в рабочей области

Операции с файлами

• upload_file(channels, content, filename, title=None) — загрузить файл на каналы
• search_files(query, count=20) - Поиск файлов в рабочей области

Реакционные операции

• add_reaction(channel, timestamp, name) — Добавить эмодзи-реакцию к сообщению
• remove_reaction(channel, timestamp, name) — Удалить эмодзи-реакцию из сообщения

Примеры

Отправка сообщения

Получение истории канала

Поиск сообщений

Создание канала

Обработка ошибок

Сервер включает в себя комплексную обработку ошибок для:

• Недействительные токены Slack
• Ограничение скорости
• Проблемы с сетевым подключением
• Неверные идентификаторы каналов/пользователей
• Ошибки разрешения

Соображения безопасности

• Храните свой токен Slack Bot в безопасности и никогда не передавайте его в систему контроля версий.
• Используйте переменные среды или безопасное управление секретами
• Регулярно меняйте токены бота
• Отслеживайте активность ботов в вашем рабочем пространстве Slack
• Предоставляйте только минимально необходимые разрешения

Внося вклад

1. Форк репозитория
2. Создать ветку функций
3. Внесите изменения
4. Добавьте тесты, если применимо
5. Отправить запрос на извлечение

Лицензия

Данный проект лицензирован по лицензии MIT — подробности см. в файле LICENSE.

Поддерживать

По вопросам и проблемам:

1. Проверьте документацию API Slack.
2. Ознакомьтесь со спецификацией MCP
3. Открыть проблему в этом репозитории