Slack MCP Server - Complete Implementation

by yeoamlog

308 downloads

Not rated

GitHub

Description

# Slack MCP Server - Complete Implementation ## 📋 프로젝트 개요 FastMCP v2를 사용하여 구현한 완전한 Slack API 연동 MCP 서버입니다. 과제 가이드라인에 따라 **필수 기능 4개**, **선택 기능 4개**, 그리고 **보너스 뽀모도로 타이머 기능 4개**를 모두 구현했습니다. ### 🎯 주요 특징 - ✅ **완전한 UTF-8 한글 지원** - 모든 메시지에서 한글 완벽 지원 - ✅ **이중 토큰 시스템** - Bot Token + User…

About

Details

Author: yeoamlog
Downloads: 308
Categories: Communication, API

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Slack MCP Server - Complete Implementation

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "slack mcp server - complete implementation": {
            "slack-mcp-server-yeoamlog": {
                "command": "uv",
                "args": [
                    "venv"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "slack mcp server - complete implementation": {
            "slack-mcp-server-yeoamlog": {
                "command": "uv",
                "args": [
                    "venv"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "slack mcp server - complete implementation": {
            "slack-mcp-server-yeoamlog": {
                "command": "uv",
                "args": [
                    "venv"
                ]
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "slack mcp server - complete implementation": {
            "slack-mcp-server-yeoamlog": {
                "command": "uv",
                "args": [
                    "venv"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "slack mcp server - complete implementation": {
            "slack-mcp-server-yeoamlog": {
                "command": "uv",
                "args": [
                    "venv"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "slack mcp server - complete implementation": {
            "slack-mcp-server-yeoamlog": {
                "command": "uv",
                "args": [
                    "venv"
                ]
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "slack mcp server - complete implementation": {
            "slack-mcp-server-yeoamlog": {
                "command": "uv",
                "args": [
                    "venv"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "slack mcp server - complete implementation": {
            "slack-mcp-server-yeoamlog": {
                "command": "uv",
                "args": [
                    "venv"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "slack mcp server - complete implementation": {
            "slack-mcp-server-yeoamlog": {
                "command": "uv",
                "args": [
                    "venv"
                ]
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "slack mcp server - complete implementation": {
            "slack-mcp-server-yeoamlog": {
                "command": "uv",
                "args": [
                    "venv"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "slack mcp server - complete implementation": {
            "slack-mcp-server-yeoamlog": {
                "command": "uv",
                "args": [
                    "venv"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "slack mcp server - complete implementation": {
            "slack-mcp-server-yeoamlog": {
                "command": "uv",
                "args": [
                    "venv"
                ]
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "slack mcp server - complete implementation": {
            "slack-mcp-server-yeoamlog": {
                "command": "uv",
                "args": [
                    "venv"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "slack mcp server - complete implementation": {
            "slack-mcp-server-yeoamlog": {
                "command": "uv",
                "args": [
                    "venv"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "slack mcp server - complete implementation": {
            "slack-mcp-server-yeoamlog": {
                "command": "uv",
                "args": [
                    "venv"
                ]
            }
        }
    }
}

From the repository

Install via uv package manager: clone the repo, run uv venv and uv sync, then create a .env file with SLACK_BOT_TOKEN (required) and optionally SLACK_USER_TOKEN and SLACK_TEST_CHANNEL_ID. Configure a Slack app with required Bot Token scopes (e.g. channels:read, chat:write) and optional User Token scopes. Start the server with python slack_mcp_server.py or uv run slack_mcp_server.py. Invoke tools (e.g. send_slack_message) through any MCP host such as Claude.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "slack mcp server - complete implementation": {
            "slack-mcp-server-yeoamlog": {
                "command": "uv",
                "args": [
                    "venv"
                ]
            }
        }
    }
}

McpServers

{
    "slack-mcp-server-yeoamlog": {
        "command": "uv",
        "args": [
            "venv"
        ]
    }
}

Slack MCP Server - Complete Implementation

📋 프로젝트 개요

FastMCP v2를 사용하여 구현한 완전한 Slack API 연동 MCP 서버입니다. 과제 가이드라인에 따라 필수 기능 4개, 선택 기능 4개, 그리고 보너스 뽀모도로 타이머 기능 4개를 모두 구현했습니다.

🎯 주요 특징

- ✅ 완전한 UTF-8 한글 지원 - 모든 메시지에서 한글 완벽 지원
- ✅ 이중 토큰 시스템 - Bot Token + User Token으로 모든 기능 지원
- ✅ 스마트 파일 업로드 - 크기별 최적 업로드 방식 자동 선택
- ✅ 뽀모도로 타이머 - 자동 알림 기능이 포함된 시간 관리 도구
- ✅ 비동기 처리 - 고성능 asyncio 기반 구현
- ✅ 상세한 에러 핸들링 - 모든 API 호출에 대한 적절한 예외 처리

🚀 기능 목록

🔴 필수 기능 (Required Features - 4개)

1. send_slack_message - 메시지 전송
- 채널 또는 DM에 메시지 전송
- 스레드 답글 지원
- 완전한 UTF-8 한글 지원

2. get_slack_channels - 채널 목록 조회
- 공개/비공개 채널 구분
- 멤버십 상태 확인
- 보관된 채널 필터링

3. get_slack_channel_history - 메시지 히스토리 조회
- 최신 메시지부터 조회
- 시간 범위 지정 가능
- 메시지 메타데이터 포함

4. send_slack_direct_message - DM 전송
- 특정 사용자에게 1:1 메시지 전송
- 자동 DM 채널 생성
- 봇 사용자 필터링

🟡 선택 기능 (Optional Features - 4개)

5. get_slack_users - 사용자 목록 조회
- 사용자 타입별 분류 (관리자, 멤버, 게스트, 봇)
- DM 가능 사용자 필터링
- 상세한 프로필 정보

6. search_slack_messages - 메시지 검색 (User Token 필요)
- 키워드 기반 전체 워크스페이스 검색
- 정렬 및 필터링 옵션
- 검색 결과 메타데이터

7. upload_file_to_slack - 스마트 파일 업로드
- 파일 크기별 최적 업로드 방식
- 다양한 파일 형식 지원
- 자동 미리보기 및 코드 하이라이팅

8. add_slack_reaction - 메시지 반응 추가
- 이모지 반응 추가
- 다양한 이모지 형식 지원

🟢 보너스 기능 (Bonus Features - 4개)

9. start_pomodoro_timer - 뽀모도로 타이머 시작
- 5가지 타이머 타입 (study, work, break, meeting, custom)
- 자동 시작/종료 알림
- 사용자 정의 시간 및 메시지

10. cancel_pomodoro_timer - 타이머 취소
- 실행 중인 타이머 즉시 중단
- 취소 알림 전송

11. list_active_timers - 활성 타이머 목록
- 현재 실행 중인 모든 타이머
- 진행률 및 남은 시간 표시

12. get_timer_status - 타이머 상태 조회
- 특정 타이머의 상세 상태
- 실시간 진행 상황

🛠️ 유틸리티 기능

13. test_slack_connection - 연결 테스트
14. get_workspace_info - 워크스페이스 정보
15. get_file_preview - 파일 미리보기
16. verify_or_create_file - 파일 확인/생성

📦 설치 및 실행 방법

1. 프로젝트 초기화

```bash

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

Description

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

Slack MCP Server - Complete Implementation

📋 프로젝트 개요

🎯 주요 특징

🚀 기능 목록

🔴 필수 기능 (Required Features - 4개)

🟡 선택 기능 (Optional Features - 4개)

🟢 보너스 기능 (Bonus Features - 4개)

🛠️ 유틸리티 기능

📦 설치 및 실행 방법

1. 프로젝트 초기화

Install

More like this

Slack

GitLab

FastAPI-MCP

Inbox Zero

AWS MCP Servers

Production-ready MCP integrations for AI applications