Zulip MCP Server

Zulip MCP 서버

Zulip API용 MCP 서버를 사용하면 Claude와 같은 AI 어시스턴트가 Zulip 작업 공간과 상호 작용할 수 있습니다.

도구

1. zulip_list_channels
   • Zulip 조직에서 사용 가능한 채널(스트림)을 나열합니다.
   • 선택 입력 사항:
     • include_private (부울, 기본값: false): 개인 스트림을 포함할지 여부
     • include_web_public (부울, 기본값: true): 웹 공개 스트림을 포함할지 여부
     • include_subscribed (부울, 기본값: true): 봇이 구독한 스트림을 포함할지 여부
   • 반환: ID와 정보가 포함된 스트림 목록
2. zulip_post_message
   • Zulip 채널(스트림)에 새 메시지를 게시하세요
   • 필수 입력 사항:
     • channel_name (문자열): 게시할 스트림의 이름
     • topic (문자열): 스트림 내의 주제
     • content (문자열): 게시할 메시지 내용
   • 반환 : 메시지 게시 확인 및 ID
3. zulip_send_direct_message
   • 한 명 이상의 사용자에게 직접 메시지를 보냅니다.
   • 필수 입력 사항:
     • recipients (string[]): 수신자의 이메일 주소 또는 사용자 ID
     • content (문자열): 보낼 메시지 내용
   • 반환 : 메시지 전송 확인 및 ID
4. zulip_add_reaction
   • 메시지에 이모티콘 반응 추가
   • 필수 입력 사항:
     • message_id (숫자): 반응할 메시지의 ID
     • emoji_name (문자열): 콜론이 없는 이모티콘 이름
   • 반환: 반응 확인
5. zulip_get_channel_history
   • 채널(스트림) 및 주제에서 최근 메시지 가져오기
   • 필수 입력 사항:
     • channel_name (문자열): 스트림의 이름
     • topic (문자열): 주제 이름
   • 선택 입력 사항:
     • limit (숫자, 기본값: 20): 검색할 메시지 수
     • anchor (문자열, 기본값: "최신"): 시작할 메시지 ID
   • 반환: 콘텐츠 및 메타데이터가 포함된 메시지 목록
6. zulip_get_topics
   • 채널(스트림)에서 주제 가져오기
   • 필수 입력 사항:
     • channel_id (숫자): 스트림의 ID
   • 반환: 스트림의 주제 목록
7. zulip_subscribe_to_channel
   • 봇을 채널(스트림)에 구독합니다.
   • 필수 입력 사항:
     • channel_name (문자열): 구독할 스트림의 이름
   • 반품: 구독 확인
8. zulip_get_users
   • Zulip 조직의 사용자 목록을 가져옵니다.
   • 반환: 기본 정보가 포함된 사용자 목록

설정

1. Zulip 봇 만들기:
   • Zulip 인스턴스에 로그인하세요
   • 설정 > 개인 > 봇으로 이동하세요.
   • "새로운 봇 추가"를 클릭하세요
   • "일반 봇" 유형을 선택하세요
   • 필수 정보를 입력하세요
   • "봇 만들기"를 클릭하세요
2. 권한:
   • 기본적으로 Zulip 봇은 제한된 권한을 갖습니다.
   • 봇이 액세스해야 하는 모든 스트림에 봇을 구독해야 합니다.
   • 봇에 더 많은 권한이 필요한 경우 대신 전체 사용자 계정을 사용하는 것이 좋습니다.
3. API 자격 증명을 받으세요.
   • 봇의 이메일 주소
   • 봇의 API 키(봇을 생성할 때 표시됨)
   • Zulip 인스턴스 URL(예: https://example.zulipchat.com )

Claude Desktop과 함께 사용

claude_desktop_config.json 에 다음을 추가하세요.

엔피엑스

지엑스피1

도커

문제 해결

권한 오류가 발생하면 다음 사항을 확인하세요.

1. 봇 API 키가 정확합니다
2. 봇은 액세스해야 하는 채널에 구독되었습니다.
3. Zulip URL은 정확하고 접근 가능합니다.

짓다

Docker 빌드:

특허

이 MCP 서버는 MIT 라이선스에 따라 라이선스가 부여되었습니다.