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組織内のユーザーのリストを取得する
- 返されるもの: ユーザーとその基本情報のリスト

設定

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

トラブルシューティング

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

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

建てる

Dockerビルド:

docker build -t mcp/zulip .

ライセンス

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

Zulip MCP Server

Integrations

Zulip MCP サーバー

ツール

設定

Claude Desktopでの使用

npx

ドッカー

トラブルシューティング

建てる

ライセンス