mcp-client-slackbot
Simple Slackbot MCP Client
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/sooperset--mcp-client-slackbot)HTML
<a href="/listings/sooperset--mcp-client-slackbot"><img src="/api/listings/sooperset--mcp-client-slackbot/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
1. Create a Slack App
1. Go to [api.slack.com/apps](https://api.slack.com/apps) and click "Create New App" 2. Choose "From an app manifest" and select your workspace 3. Copy the contents of `mcp_simple_slackbot/manifest.yaml` into the manifest editor 4. Create the app and install it to your workspace 5. Under the "Basic Information" section, scroll down to "App-Level Tokens" 6. Click "Generate Token and Scopes" and: - Enter a name like "mcp-assistant" - Add the `connections:write` scope - Click "Generate" 7. Take note of both your: - Bot Token (`xoxb-...`) found in "OAuth & Permissions" - App Token (`xapp-...`) that you just generated
2. Install Dependencies
# Create a virtual environment python -m venv venv # Activate the virtual environment source venv/bin/activate # On Windows: venv\Scripts\activate # Install project dependencies pip install -r mcp_simple_slackbot/requirements.txt
3. Configure Environment Variables
Create a `.env` file in the `mcp_simple_slackbot` directory (see `.env.example` for a template):
# Slack API credentials SLACK_BOT_TOKEN=xoxb-your-token SLACK_APP_TOKEN=xapp-your-token # LLM API credentials OPENAI_API_KEY=sk-your-openai-key # or use GROQ_API_KEY or ANTHROPIC_API_KEY # LLM configuration LLM_MODEL=gpt-4-turbo
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 104 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # MCP Simple Slackbot
- A simple Slack bot that uses the Model Context Protocol (MCP) to enhance its capabilities with external tools.
- ## Features
- 
- - **AI-Powered Assistant**: Responds to messages in channels and DMs using LLM capabilities
- - **MCP Integration**: Full access to MCP tools like SQLite database and web fetching
- - **Multi-LLM Support**: Works with OpenAI, Groq, and Anthropic models
- - **App Home Tab**: Shows available tools and usage information
- ## Setup
- ### 1. Create a Slack App
- 1. Go to [api.slack.com/apps](https://api.slack.com/apps) and click "Create New App"
- 2. Choose "From an app manifest" and select your workspace
- 3. Copy the contents of `mcp_simple_slackbot/manifest.yaml` into the manifest editor
- 4. Create the app and install it to your workspace
- 5. Under the "Basic Information" section, scroll down to "App-Level Tokens"
- 6. Click "Generate Token and Scopes" and:
- - Enter a name like "mcp-assistant"
- - Add the `connections:write` scope
- - Click "Generate"
- 7. Take note of both your:
- - Bot Token (`xoxb-...`) found in "OAuth & Permissions"
- - App Token (`xapp-...`) that you just generated
- ### 2. Install Dependencies
- ```bash
- # Create a virtual environment
- python -m venv venv
- # Activate the virtual environment
- source venv/bin/activate # On Windows: venv\Scripts\activate
- # Install project dependencies
- pip install -r mcp_simple_slackbot/requirements.txt
- ```
- ### 3. Configure Environment Variables
- Create a `.env` file in the `mcp_simple_slackbot` directory (see `.env.example` for a template):
- ```
- # Slack API credentials
- SLACK_BOT_TOKEN=xoxb-your-token
- SLACK_APP_TOKEN=xapp-your-token
- # LLM API credentials
- OPENAI_API_KEY=sk-your-openai-key
- # or use GROQ_API_KEY or ANTHROPIC_API_KEY
- # LLM configuration
- LLM_MODEL=gpt-4-turbo
- ```
- ## Running the Bot
- ```bash
- # Navigate to the module directory
- cd mcp_simple_slackbot
- # Run the bot directly
- python main.py
- ```
- The bot will:
- 1. Connect to all configured MCP servers
- 2. Discover available tools
- 3. Start the Slack app in Socket Mode
- 4. Listen for mentions and direct messages
- ## Usage
- - **Direct Messages**: Send a direct message to the bot
- - **Channel Mentions**: Mention the bot in a channel with `@MCP Assistant`
- - **App Home**: Visit the bot's App Home tab to see available tools
- ## Architecture
- The bot is designed with a focused architecture:
- 1. **SlackMCPBot**: Core class managing Slack events and message processing
- 2. **LLMClient**: Handles communication with LLM APIs (OpenAI, Groq, Anthropic)
- 3. **Server**: Manages communication with MCP servers
- 4. **Tool**: Represents available tools from MCP servers
- When a message is received, the bot:
- 1. Sends the message to the LLM along with available tools
- 2. If the LLM response includes a tool call, executes the tool
- 3. Returns the result to the LLM for interpretation
- 4. Delivers the final response to the user
- ## Credits
- This project is based on the [MCP Simple Chatbot example](https://github.com/modelcontextprotocol/python-sdk/tree/main/examples/clients/simple-chatbot).
- ## License
- MIT License
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.