thinkingmachines/slack-mcp

Slack MCP Server

Proof-of-concept Slack MCP server

📋 Prerequisites

• Python 3.8+
• Azure CLI
• Docker
• Slack App credentials (Client ID and Secret)
• direnv

Local Development

1. Clone the repository

   git clone https://github.com/thinkingmachines/slack-mcp
   cd slack-mcp
   

2. Set up development environment

   make dev
   

3. Fill out the .envrc file with the require values

4. Start the server

   make start
   

🔧 Development

Available Make Commands

• make dev - Set up development environment
• make start - Start the development server
• make test - Run test suite
• make status - Check development environment status
• make deploy - Quick Deploy to Azure Container Apps

Running Tests

# Run all tests
make test

# Run specific test file
uv run pytest tests/test_server.py -v

# Run with coverage
uv run pytest tests/ --cov=src/slack_mcp_server

Project Structure

slack-mcp/
├── src/
│   └── slack_mcp_server/
│       ├── __init__.py
│       ├── main.py              # FastAPI application
│       ├── azure_keyvault.py    # Azure Key Vault wrapper
│       └── slack_mcp.py         # Slack MCP implementation
├── tests/                       # Test suite
├── Dockerfile                   # Docker configuration
├── docker-compose.yml           # Docker Compose setup
├── pyproject.toml               # Project configuration
├── Makefile                     # Development automation
└── quick-deploy.sh              # Azure deployment script

🚀 Deployment

Azure Container Apps

1. Prerequisites

   • Azure CLI installed and authenticated
   • Azure Key Vault created with proper RBAC permissions
   • Service Principal with Key Vault access

2. Deploy

   make deploy
   

   This will:

   • Build and push Docker image to Azure Container Registry
   • Create/update Azure Container App
   • Configure environment variables

🔧 Configuration

Environment Variables

Slack App Configuration

1. Create a Slack app at api.slack.com/apps
2. Configure OAuth & Permissions
3. Add required scopes:
   • channels:history
   • channels:read
   • chat:write
   • groups:read
   • groups:write
   • im:history
   • im:read
   • im:write
   • mpim:history
   • mpim:read
   • mpim:write
   • search:read
   • users:read