Zulip MCP サーバー

Zulip API 用の MCP サーバー。Claude などの AI アシスタントが Zulip ワークスペースと対話できるようになります。

ツール

zulip_list_channels
- Zulip 組織内の利用可能なチャンネル（ストリーム）を一覧表示します
- オプション入力:
  - include_private (ブール値、デフォルト: false): プライベートストリームを含めるかどうか
  - include_web_public (ブール値、デフォルト: true): Web公開ストリームを含めるかどうか
  - include_subscribed (ブール値、デフォルト: true): ボットが購読しているストリームを含めるかどうか
- 戻り値: IDと情報を含むストリームのリスト
zulip_post_message
- Zulip チャンネル (ストリーム) に新しいメッセージを投稿する
- 必要な入力:
  - channel_name (文字列): 投稿先のストリームの名前
  - topic (文字列): ストリーム内のトピック
  - content (文字列): 投稿するメッセージの内容
- 戻り値: メッセージ投稿の確認とID
zulip_send_direct_message
- 1人または複数のユーザーにダイレクトメッセージを送信する
- 必要な入力:
  - recipients (文字列[]): 受信者のメールアドレスまたはユーザーID
  - content (文字列): 送信するメッセージの内容
- 戻り値: メッセージ送信確認とID
zulip_add_reaction
- メッセージに絵文字リアクションを追加する
- 必要な入力:
  - message_id (数値): 反応するメッセージのID
  - emoji_name (文字列): コロンを除いた絵文字名
- 返品：反応確認
zulip_get_channel_history
- チャンネル（ストリーム）とトピックから最近のメッセージを取得する
- 必要な入力:
  - channel_name (文字列): ストリームの名前
  - topic (文字列): トピック名
- オプション入力:
  - limit （数値、デフォルト：20）：取得するメッセージの数
  - anchor （文字列、デフォルト："newest"）：開始するメッセージ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に以下を追加します。

npx

{ "mcpServers": { "zulip": { "command": "npx", "args": [ "-y", "@modelcontextprotocol/server-zulip" ], "env": { "ZULIP_EMAIL": "your-bot@example.zulipchat.com", "ZULIP_API_KEY": "your-bot-api-key", "ZULIP_URL": "https://example.zulipchat.com" } } } }

ドッカー

{ "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" } } } }