Zulip MCP Server

Zulip MCP サーバー

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

ツール

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

npx

ドッカー

トラブルシューティング

権限エラーが発生した場合は、次の点を確認してください。

1. ボットAPIキーは正しいです
2. ボットはアクセスする必要があるチャンネルに登録されています
3. ZulipのURLは正しくアクセス可能です

建てる

Dockerビルド:

ライセンス

この MCP サーバーは MIT ライセンスに基づいてライセンスされます。