Zulip MCP 서버

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

도구

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

Related MCP server: Hass-MCP

설정

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

Claude Desktop과 함께 사용

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

엔피엑스

지엑스피1

도커

{ "mcpServers": { "zulip": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "ZULIP_EMAIL", "-e", "ZULIP_API_KEY", "-e", "ZULIP_URL", "mcp/zulip" ], "env": { "ZULIP_EMAIL": "your-bot@example.zulipchat.com", "ZULIP_API_KEY": "your-bot-api-key", "ZULIP_URL": "https://example.zulipchat.com" } } } }