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 라이선스에 따라 라이선스가 부여되었습니다.