Skip to main content
Glama

Slack MCP Server

by teresjsiu
GitHub
Python
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

🚀 Slack MCP Server

FastMCP를 사용한 완전한 Slack 통합 MCP 서버입니다. Cursor IDE에서 Slack API의 모든 기능을 자연어로 사용할 수 있게 해줍니다.

📋 목차

✨ 특징

필수 기능 (과제 요구사항)

  • ✅ 메시지 전송: 채널에 메시지 전송
  • ✅ 채널 목록 조회: 접근 가능한 모든 채널 조회
  • ✅ 채널 히스토리 조회: 지정된 채널의 메시지 히스토리
  • ✅ 다이렉트 메시지: 1:1 메시지 전송

추가 기능

  • ✅ 사용자 목록 조회: 워크스페이스 사용자 정보
  • ✅ 반응 추가: 메시지에 이모지 반응 추가
  • ✅ 메시지 검색: 키워드 기반 메시지 검색
  • ✅ 연결 테스트: API 연결 상태 확인

기술적 특징

  • 🚀 FastMCP 기반: 최신 MCP 프레임워크 사용
  • ⚡ 비동기 처리: aiohttp를 이용한 고성능 API 호출
  • 🛡️ 완전한 에러 처리: 상세한 오류 메시지와 복구 가능한 예외 처리
  • 📝 타입 힌트: 완전한 타입 안정성
  • 🧪 포괄적 테스트: 자동화된 테스트 스위트
  • 📊 로깅: 구조화된 로깅 시스템
  • 🔧 자동 설치: 원클릭 설치 스크립트

📋 요구사항

  • Python 3.8+
  • pip (패키지 관리자)
  • Cursor IDE (MCP 클라이언트)
  • Slack Bot Token (xoxb-로 시작)

Slack Bot 권한

Slack 앱에 다음 권한이 필요합니다:

Bot Token Scopes: - channels:history # 채널 메시지 읽기 - channels:read # 채널 정보 조회 - chat:write # 메시지 전송 - groups:history # 비공개 그룹 메시지 읽기 - groups:read # 비공개 그룹 정보 조회 - im:history # DM 메시지 읽기 - im:read # DM 정보 조회 - im:write # DM 전송 - mpim:history # 멀티파티 DM 메시지 읽기 - mpim:read # 멀티파티 DM 정보 조회 - mpim:write # 멀티파티 DM 전송 - reactions:write # 반응 추가 - search:read # 메시지 검색 - users:read # 사용자 정보 조회

🚀 빠른 설치

1. 자동 설치 (권장)

cd slack-mcp python install.py

설치 스크립트가 다음을 자동으로 처리합니다:

  • 패키지 설치
  • 환경 변수 설정
  • Cursor MCP 설정 업데이트
  • 설치 테스트 실행

2. Cursor 재시작

설치 완료 후 Cursor를 재시작하면 Slack MCP 도구를 사용할 수 있습니다.

🔧 수동 설치

1. 저장소 클론

git clone <repository-url> cd slack-mcp

2. 패키지 설치

pip install -r requirements.txt

3. 환경 변수 설정

.env 파일 생성:

# Slack Bot Token (xoxb-로 시작하는 토큰) SLACK_BOT_TOKEN=xoxb-your-bot-token-here # 선택적: 로그 레벨 설정 LOG_LEVEL=INFO

4. Cursor MCP 설정

~/.cursor/mcp.json 파일에 다음 추가:

{ "mcpServers": { "slack": { "command": "python", "args": ["/path/to/slack-mcp/slack_mcp_server.py"], "env": { "SLACK_BOT_TOKEN": "xoxb-your-bot-token-here" } } } }

5. 테스트 실행

python test_slack_mcp.py

📖 사용법

Cursor에서 새 채팅을 시작하고 다음과 같이 자연어로 Slack 기능을 사용할 수 있습니다:

메시지 전송

#general 채널에 "안녕하세요!"라는 메시지를 보내주세요

채널 정보 조회

사용 가능한 Slack 채널 목록을 보여주세요

메시지 히스토리

#general 채널의 최근 메시지 10개를 가져와주세요

다이렉트 메시지

사용자 U1234567890에게 "회의 준비 완료"라는 DM을 보내주세요

메시지 검색

"프로젝트"라는 키워드가 포함된 메시지를 검색해주세요

🛠️ 사용 가능한 도구

도구설명파라미터
send_slack_message채널에 메시지 전송channel, text
get_slack_channels채널 목록 조회없음
get_slack_channel_history채널 히스토리 조회channel_id, limit
send_slack_direct_message다이렉트 메시지 전송user_id, text
get_slack_users사용자 목록 조회없음
add_slack_reaction메시지에 반응 추가channel, timestamp, name
search_slack_messages메시지 검색query, count
test_slack_connection연결 테스트없음

📁 프로젝트 구조

slack-mcp/ ├── 📄 README.md # 이 파일 ├── 📄 requirements.txt # Python 패키지 의존성 ├── 📄 slack_api.py # Slack API 클라이언트 ├── 📄 slack_mcp_server.py # FastMCP 서버 구현 ├── 📄 test_slack_mcp.py # 테스트 스크립트 ├── 📄 install.py # 자동 설치 스크립트 ├── 📄 mcp_config.json # MCP 설정 템플릿 ├── 📄 env_example.txt # 환경 변수 템플릿 └── 📄 .gitignore # Git 무시 파일

👨‍💻 개발자 가이드

개발 환경 설정

# 개발 모드로 패키지 설치 pip install -r requirements.txt # 환경 변수 설정 cp env_example.txt .env # .env 파일을 편집하여 실제 토큰 입력 # 테스트 실행 python test_slack_mcp.py

새로운 도구 추가

  1. slack_api.py에 API 메서드 추가
  2. slack_mcp_server.py에 MCP 도구 데코레이터 추가
  3. test_slack_mcp.py에 테스트 케이스 추가

로깅

서버는 다음 위치에 로그를 기록합니다:

  • 콘솔 출력: 실시간 로그 확인
  • 파일 로그: slack_mcp.log

디버깅

# 상세 로그와 함께 테스트 실행 LOG_LEVEL=DEBUG python test_slack_mcp.py # 서버 직접 실행 (디버깅용) python slack_mcp_server.py

🔍 문제 해결

자주 발생하는 문제

1. "SLACK_BOT_TOKEN 환경 변수가 설정되지 않았습니다"

해결책:

  • .env 파일에 올바른 토큰이 있는지 확인
  • 토큰이 xoxb-로 시작하는지 확인
2. "invalid_auth" 에러

해결책:

  • Slack Bot Token이 유효한지 확인
  • 토큰이 올바른 워크스페이스용인지 확인
  • 필요한 권한이 모두 부여되었는지 확인
3. "channel_not_found" 에러

해결책:

  • 채널 ID가 올바른지 확인
  • 봇이 해당 채널에 추가되었는지 확인
  • 공개 채널인지 또는 봇이 초대되었는지 확인
4. Cursor에서 MCP 도구가 보이지 않음

해결책:

  • Cursor를 완전히 재시작
  • ~/.cursor/mcp.json 설정 파일 확인
  • 파일 경로가 올바른지 확인

로그 확인

# 서버 로그 확인 tail -f slack_mcp.log # 테스트 로그와 함께 실행 python test_slack_mcp.py 2>&1 | tee debug.log

수동 연결 테스트

# Python에서 직접 테스트 python -c " import asyncio from slack_api import get_slack_client import os from dotenv import load_dotenv load_dotenv() token = os.getenv('SLACK_BOT_TOKEN') client = get_slack_client(token) async def test(): result = await client.test_connection() print(result) asyncio.run(test()) "

📋 과제 요구사항 대비 현황

요구사항상태구현 위치
필수 기능
메시지 전송✅ 완료send_slack_message
채널 목록 조회✅ 완료get_slack_channels
채널 히스토리 조회✅ 완료get_slack_channel_history
다이렉트 메시지✅ 완료send_slack_direct_message
선택 기능
사용자 목록 조회✅ 완료get_slack_users
반응 추가✅ 완료add_slack_reaction
메시지 검색✅ 완료search_slack_messages
기술 요구사항
FastMCP 사용✅ 완료slack_mcp_server.py
에러 처리✅ 완료모든 도구에 try-catch
타입 힌트✅ 완료모든 함수에 타입 힌트
로깅✅ 완료구조화된 로깅 시스템
테스트✅ 완료test_slack_mcp.py
문서화✅ 완료이 README 및 코드 주석

🏆 추가 구현 사항

과제 요구사항을 넘어서 다음 기능들을 추가로 구현했습니다:

  • 🔄 자동 설치 시스템: 원클릭 설치 스크립트
  • 🧪 포괄적 테스트: 모든 기능에 대한 자동화된 테스트
  • 📊 상세한 응답 포맷팅: 구조화된 성공/실패 응답
  • ⚡ 비동기 HTTP 클라이언트: 고성능 aiohttp 사용
  • 🛡️ 세션 관리: HTTP 세션 재사용으로 성능 최적화
  • 🔧 개발자 도구: 디버깅 및 문제 해결 도구
  • 📁 완전한 프로젝트 구조: 생산 준비 완료된 코드 구조

📄 라이선스

MIT License - 자세한 내용은 LICENSE 파일을 참조하세요.

🚀 시작하기

# 1. 프로젝트 클론 git clone <repository-url> cd slack-mcp # 2. 자동 설치 실행 python install.py # 3. Cursor 재시작 # 이제 Cursor에서 Slack MCP 도구를 사용할 수 있습니다!

문제가 있으시면 Issues에 보고해주세요.

This server cannot be installed

-
security - not tested
F
license - not found
-
quality - not tested

How are these scores calculated?

A FastMCP-based server that provides complete Slack integration for Cursor IDE, allowing users to interact with Slack API features using natural language.

  1. 📋 목차
    1. ✨ 특징
      1. 필수 기능 (과제 요구사항)
      2. 추가 기능
      3. 기술적 특징
    2. 📋 요구사항
      1. Slack Bot 권한
    3. 🚀 빠른 설치
      1. 자동 설치 (권장)
      2. Cursor 재시작
    4. 🔧 수동 설치
      1. 저장소 클론
      2. 패키지 설치
      3. 환경 변수 설정
      4. Cursor MCP 설정
      5. 테스트 실행
    5. 📖 사용법
      1. 메시지 전송
      2. 채널 정보 조회
      3. 메시지 히스토리
      4. 다이렉트 메시지
      5. 메시지 검색
    6. 🛠️ 사용 가능한 도구
      1. 📁 프로젝트 구조
        1. 👨‍💻 개발자 가이드
          1. 개발 환경 설정
          2. 새로운 도구 추가
          3. 로깅
          4. 디버깅
        2. 🔍 문제 해결
          1. 자주 발생하는 문제
          2. 로그 확인
          3. 수동 연결 테스트
        3. 📋 과제 요구사항 대비 현황
          1. 🏆 추가 구현 사항
            1. 📄 라이선스
              1. 🚀 시작하기

                Related MCP Servers

                • Apifox MCP Serverofficial

                  apifox
                  -
                  security
                  F
                  license
                  -
                  quality
                  A server that connects AI coding assistants like Cursor and Cline to Apifox API definitions, allowing developers to implement API interfaces through natural language commands.
                  Last updated -
                  832
                  1
                  • Apple
                  • Linux

                • ActionKit MCP Server

                  jackmuva
                  -
                  security
                  F
                  license
                  -
                  quality
                  An MCP server that connects to Claude Desktop and provides access to Slack actions through ActionKit, allowing users to interact with Slack via their authenticated Paragon credentials.
                  Last updated -
                  1
                  TypeScript
                  • Apple

                • MCP-Devin

                  kazuph
                  A
                  security
                  F
                  license
                  A
                  quality
                  A TypeScript MCP server that integrates Devin AI with Slack, allowing users to create Devin sessions, post tasks to Slack channels, and maintain thread context between Devin sessions and Slack threads.
                  Last updated -
                  5
                  JavaScript
                  • Apple

                View all related MCP servers

                New MCP Servers

                MCP directory API

                We provide all the information about MCP servers via our MCP API.

                curl -X GET 'https://glama.ai/api/mcp/v1/servers/teresjsiu/MCP'

                If you have feedback or need assistance with the MCP directory API, please join our Discord server