Slack MCP Server

슬랙 MCP 서버

AI 비서가 Slack 작업 공간과 상호 작용할 수 있도록 하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 Slack API를 통해 메시지 읽기, 게시, 채널 관리 등의 도구를 제공합니다.

특징

• 채널 관리 : 채널 목록, 채널 정보 가져오기, 채널 생성
• 메시지 작업 : 메시지 보내기, 메시지 기록 읽기, 스레드에 답장하기
• 사용자 관리 : 사용자 정보 가져오기, 작업 공간 구성원 목록 작성
• 파일 작업 : 파일 업로드, 채널에서 파일 공유
• 검색 : 작업 공간 전체에서 메시지와 파일을 검색합니다.
• 반응 : 메시지에 이모티콘 반응을 추가하고 제거합니다.

필수 조건

• Python 3.8 이상
• 관리자 권한이 있는 Slack 작업 공간
• 적절한 범위를 갖춘 Slack Bot 토큰

설치

1. 이 저장소를 복제하세요:

지엑스피1

2. 종속성 설치:

3. Slack Bot 토큰을 설정하세요(아래 구성 섹션 참조)

구성

Slack Bot 토큰 설정

1. Slack API 로 이동하여 새 앱을 만듭니다.
2. 사이드바에서 "OAuth 및 권한"으로 이동합니다.
3. 다음 봇 토큰 범위를 추가합니다.
   • channels:read - 공개 채널에 대한 기본 정보 보기
   • channels:write - 공개 채널 관리
   • chat:write - 봇으로 메시지 보내기
   • chat:write.public - 봇이 소속되지 않은 채널에 메시지 보내기
   • files:read - 채널 및 대화에서 공유된 파일 보기
   • files:write - 파일 업로드, 편집 및 삭제
   • groups:read - 개인 채널에 대한 기본 정보 보기
   • im:read - 다이렉트 메시지에 대한 기본 정보 보기
   • mpim:read - 그룹 직접 메시지에 대한 기본 정보 보기
   • reactions:read - 이모티콘 반응과 관련 콘텐츠 보기
   • reactions:write - 이모티콘 반응 추가 및 편집
   • search:read - 메시지 및 파일 검색
   • users:read - 작업 공간에 있는 사람 보기
   • channels:history - 공개 채널의 메시지 및 기타 콘텐츠 보기
   • groups:history - 개인 채널에서 메시지 및 기타 콘텐츠 보기
   • im:history - 다이렉트 메시지의 메시지 및 기타 콘텐츠 보기
   • mpim:history - 그룹 직접 메시지의 메시지 및 기타 콘텐츠 보기
4. 작업 공간에 앱을 설치하세요
5. "봇 사용자 OAuth 토큰"( xoxb- 로 시작)을 복사하세요.

환경 변수

Slack Bot 토큰을 환경 변수로 설정하세요.

또는 프로젝트 루트에 .env 파일을 만듭니다.

용법

서버 실행

서버가 시작되고 stdio를 통해 MCP 연결을 수신합니다.

Claude Desktop과 함께 사용

Claude Desktop 구성 파일에 다음 구성을 추가하세요.

사용 가능한 도구

서버는 다음과 같은 도구를 제공합니다.

채널 운영

• list_channels() - 작업 공간의 모든 채널을 나열합니다.
• get_channel_info(channel_id) - 채널에 대한 자세한 정보를 가져옵니다.
• create_channel(name, is_private=False) - 새 채널을 만듭니다.

메시지 작업

• send_message(channel, text, thread_ts=None) - 채널에 메시지를 보냅니다.
• get_channel_history(channel, limit=10) - 채널의 최근 메시지 가져오기
• search_messages(query, count=20) - 작업 공간 전체에서 메시지 검색

사용자 작업

• get_user_info(user_id) - 사용자에 대한 정보를 가져옵니다.
• list_users() - 작업 공간에 있는 모든 사용자를 나열합니다.

파일 작업

• upload_file(channels, content, filename, title=None) - 채널에 파일 업로드
• search_files(query, count=20) - 작업 공간에서 파일 검색

반응 연산

• add_reaction(channel, timestamp, name) - 메시지에 이모티콘 반응을 추가합니다.
• remove_reaction(channel, timestamp, name) - 메시지에서 이모티콘 반응을 제거합니다.

예시

메시지 보내기

채널 기록 가져오기

메시지 검색

채널 만들기

오류 처리

서버에는 다음에 대한 포괄적인 오류 처리 기능이 포함되어 있습니다.

• 잘못된 Slack 토큰
• 속도 제한
• 네트워크 연결 문제
• 잘못된 채널/사용자 ID입니다
• 권한 오류

보안 고려 사항

• Slack Bot 토큰을 안전하게 보관하고 버전 제어에 커밋하지 마세요.
• 환경 변수를 사용하거나 비밀 관리를 보호하세요
• 정기적으로 봇 토큰을 순환하세요
• Slack 작업 공간에서 봇 활동 모니터링
• 최소한으로 필요한 권한만 부여하세요

기여하다

1. 저장소를 포크하세요
2. 기능 브랜치 생성
3. 변경 사항을 만드세요
4. 해당되는 경우 테스트를 추가하세요
5. 풀 리퀘스트 제출

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

지원하다

문제 및 질문:

1. Slack API 문서를 확인하세요
2. MCP 사양을 검토하세요
3. 이 저장소에서 이슈를 열어보세요