MCP 服务器

Slack MCP Server

A strong MCP server for Slack integration, providing standardized access to Slack's API features through both MCP tools and webhook processing.

README

<h1 align="center"> Slack MCP Server </h1>

</p>

Overview

🦾 A strong MCP (Model Context Protocol) server for Slack integration, providing standardized access to Slack's API features through both MCP tools and webhook processing.

Key Features:

🤖 MCP Server: Provides 6 essential Slack tools for AI assistants and clients
🪝 Webhook Server: Processes real-time Slack events with secure verification
🔗 Integrated Mode: Combined MCP + webhook server for complete Slack platform integration
🚀 Multiple Transports: Supports stdio, SSE, HTTP streaming, and Socket Mode protocols
📦 Easy Deployment: Docker, Kubernetes, and cloud platform ready
🔌 Socket Mode: WebSocket-based transport for environments without public HTTP endpoints

Use Cases:

Building AI assistants with Slack integration
Creating custom automation tools for Slack workflows
Developing real-time Slack applications with event processing
Integrating Slack with other tools and platforms

Python versions support

slack-mcp-server supports Python 3.12+ for optimal performance and modern language features.

Quickly Start

Installation

Choose your preferred installation method:

Using pip

# Minimal base (protocol only)
pip install slack-mcp

# MCP server feature set
pip install "slack-mcp[mcp]"

# Webhook server feature set
pip install "slack-mcp[webhook]"

# Everything
pip install "slack-mcp[all]"

Using uv (recommended)

# Minimal base
uv add slack-mcp

# MCP server / Webhook / All
uv add "slack-mcp[mcp]"
uv add "slack-mcp[webhook]"
uv add "slack-mcp[all]"

Using poetry

# Minimal base
poetry add slack-mcp

# MCP server / Webhook / All
poetry add slack-mcp -E mcp
poetry add slack-mcp -E webhook
poetry add slack-mcp -E all

Note: Installation extras

[mcp]: Installs the MCP server feature set (SSE/Streamable transports; not the integrated webhook mode)

[webhook]: Installs FastAPI/Uvicorn and related parts for Slack webhook handling (not the integrated mode)

[all]: Installs everything in this project

Base (no extra): Minimal install with only the base protocol rules of this project

Basic Usage

1. Set Up Environment Variables

For Production/Development:

# Copy the production environment template
cp .env.example .env

# Edit with your actual values
# Required: Slack bot token
export SLACK_BOT_TOKEN="xoxb-your-bot-token-here"

# Optional: For webhook server
export SLACK_SIGNING_SECRET="your-signing-secret"

# Optional: For Socket Mode transport
export SLACK_APP_TOKEN="xapp-your-app-token-here"

For Testing:

# Copy the test environment template
cp test/.env.test.example test/.env.test

# Edit with your test values (used by pytest)
# Required: E2E test token
export E2E_TEST_API_TOKEN="xoxb-your-test-token"

2. Start MCP Server (Standalone)

# Start with stdio transport (default)
slack-mcp-server

# Start with SSE transport for web clients
slack-mcp-server --transport sse --host 0.0.0.0 --port 3001

# Start with Socket Mode transport for WebSocket connections
slack-mcp-server --transport socket-mode --app-token xapp-your-app-token

3. Start Webhook Server (Standalone)

# Start standalone webhook server
slack-webhook-server --host 0.0.0.0 --port 3000

4. Start Integrated Server (MCP + Webhook)

# Combined server with both MCP and webhook functionality
slack-mcp-server --integrated --transport sse --port 8000

Available MCP Tools

Tool	Description	Usage
`slack_post_message`	Send messages to channels	Post notifications, updates
`slack_read_channel_messages`	Read channel message history	Analyze conversations
`slack_read_thread_messages`	Read thread replies	Follow discussions
`slack_thread_reply`	Reply to message threads	Engage in conversations
`slack_read_emojis`	Get workspace emojis	Access custom reactions
`slack_add_reactions`	Add emoji reactions	React to messages

Docker Quick Start

# Pull and run with environment variables
docker run -p 3000:3000 \
  -e SLACK_BOT_TOKEN="xoxb-your-token" \
  -e SLACK_SIGNING_SECRET="your-secret" \
  chisanan232/slack-mcp-server:latest

Socket Mode Transport

Socket Mode is a WebSocket-based transport that allows the Slack MCP server to communicate with Slack without requiring public HTTP endpoints. This is particularly useful for:

Applications behind firewalls or NAT
Environments without public internet access
Enhanced security through WebSocket tunneling
Development and testing without public infrastructure

Setup Requirements:

Enable Socket Mode in your Slack App:
- Go to https://api.slack.com/apps → Your App → Basic Information
- Enable Socket Mode
- Create an App-Level Token with connections:write scope
Configure Environment Variables:

# Required for Socket Mode
export SLACK_BOT_TOKEN="xoxb-your-bot-token-here"
export SLACK_APP_TOKEN="xapp-your-app-token-here"

Usage Examples:

# Start with Socket Mode transport
slack-mcp-server --transport socket-mode --app-token xapp-your-app-token

# Socket Mode with app token from environment variable
export SLACK_APP_TOKEN="xapp-your-app-token"
slack-mcp-server --transport socket-mode

Important Notes:

Socket Mode is a standalone transport and cannot be used with integrated mode
The app token must start with xapp- prefix
Socket Mode uses WebSocket connections directly to Slack's servers
No public HTTP endpoints or webhooks are required
Automatic reconnection with exponential backoff is built-in

Documentation

Comprehensive documentation is available at https://chisanan232.github.io/slack-mcp-server/

Documentation Sections

📖 User Guide - Installation, configuration, and usage
🛠️ Developer Guide - Contributing, architecture, and development workflow
🏗️ API Reference - Complete CLI and configuration reference
🚀 Deployment Guide - Production deployment patterns

Quick Links

Coding style and following rules

slack-mcp-server follows coding styles black and PyLint to control code quality, with additional tools for comprehensive code analysis.

Code Quality Tools

Black: Consistent code formatting
PyLint: Code analysis and style checking
MyPy: Static type checking
isort: Import sorting and organization
Pre-commit: Automated code quality checks

Development Workflow

# Install development dependencies
uv sync --dev

# Run code quality checks
uv run pre-commit run --all-files

# Run tests
uv run pytest

Downloading state

Current download statistics for slack-mcp package:

Container Downloads

Contributing

We welcome contributions! Please see our Contributing Guide for details.

Quick Contribution Steps

Report Issues - Found a bug? Let us know!
Request Features - Have ideas? We'd love to hear them!
Join Discussions - Connect with the community
Development Setup - Start contributing code

Extend with Custom Queue Backend Plugins

Want to add support for additional message queue systems? Create custom queue backend plugins using our template:

Slack MCP Server Backend MQ Template - Quick-start template for developing queue backend plugins

Complete project structure with best practices
Pre-configured CI/CD workflows
Comprehensive documentation

📚 Documentation: https://chisanan232.github.io/Slack-MCP-Server-Backend-MQ-Template/

License

MIT License