KimpalbokTV Slack

Um servidor Slack para gerenciar canais, mensagens e usuários do workspace, criado por KimpalbokTV.

Documentação

Exemplo de Servidor MCP Slack do KimpalbokTV

Este repositório contém o código de exemplo do servidor Slack MCP (Model Context Protocol) usado pelo KimpalbokTV. Ele se integra ao workspace do Slack e fornece vários recursos relacionados a canais, mensagens e usuários.

Principais recursos

Consulta da lista de canais públicos ou predefinidos do workspace
Publicação de mensagens em canais e respostas em threads
Adição de reações com emojis a mensagens
Consulta do histórico de mensagens do canal e respostas em threads
Consulta de informações de usuários e perfis do workspace

Instalação e build

{
  "mcpServers": {
    "kimpalbok-slack-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "kimpalbok-slack-mcp-server"
      ]
    },
    "env": {
      "SLACK_BOT_TOKEN": "xoxb-...",
      "SLACK_TEAM_ID": "T12345678"
    }
  }
}

Configuração de variáveis de ambiente

Antes de executar, as seguintes variáveis de ambiente devem ser configuradas.

SLACK_BOT_TOKEN: Token do bot do Slack (exemplo: xoxb-...)
SLACK_TEAM_ID: ID do time do workspace do Slack (exemplo: T12345678)
(Opcional) SLACK_CHANNEL_IDS: Lista de IDs de canais predefinidos (separados por vírgula)

Exemplo:

export SLACK_BOT_TOKEN=xoxb-...
export SLACK_TEAM_ID=T12345678
export SLACK_CHANNEL_IDS=C12345678,C23456789

Configuração do bot do Slack

Link de configuração do app e do bot https://api.slack.com/apps

No menu "OAuth & Permissions", consulte o "Bot User OAuth Token".
No menu "OAuth & Permissions", adicione permissões em "Scopes".
Como verificar o SLACK_TEAM_ID
Acesse https://apps.slack.com e execute no navegador.
A string que começa com "T..." na URL é o TEAM_ID.

Exemplos de uso

O servidor fornece várias ferramentas por meio do protocolo MCP.
Abaixo estão as principais ferramentas suportadas e suas descrições.

Nome da ferramenta	Descrição
slack_list_channels	Consulta a lista de canais públicos ou predefinidos do workspace
slack_post_message	Publica uma nova mensagem em um canal
slack_reply_to_thread	Responde a um thread de mensagem específico
slack_add_reaction	Adiciona uma reação com emoji a uma mensagem
slack_get_channel_history	Obtém as mensagens recentes de um canal
slack_get_thread_replies	Obtém todas as respostas de um thread de mensagem
slack_get_users	Obtém todos os usuários e informações básicas de perfil do workspace
slack_get_user_profile	Obtém informações detalhadas de perfil de um usuário específico

Consulte a definição de Tool e os tipos TypeScript no código para ver os parâmetros de entrada e valores de retorno de cada ferramenta.

Referências

Este servidor é baseado no MCP (Model Context Protocol) e opera com transporte baseado em entrada/saída padrão (stdio).
Para integração real com a API do Slack, é necessário um token de bot do Slack com as permissões corretas.

Contato: KimpalbokTV