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組織内のユーザーのリストを取得する

   • 返されるもの: ユーザーとその基本情報のリスト

Related MCP server: Hass-MCP

設定

1. Zulip ボットを作成する:

   • Zulipインスタンスにログインする

   • 設定 > 個人 > ボットに移動します

   • 「新しいボットを追加」をクリックします

   • 「汎用ボット」タイプを選択

   • 必要な情報を入力してください

   • 「ボットを作成」をクリックします

2. 権限:

   • デフォルトでは、Zulipボットには制限された権限があります

   • ボットがアクセスする必要があるストリームを必ず購読してください

   • ボットにさらに多くの権限が必要な場合は、代わりにフルユーザーアカウントの使用を検討してください。

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

トラブルシューティング

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

1. ボットAPIキーは正しいです

2. ボットはアクセスする必要があるチャンネルに登録されています

3. ZulipのURLは正しくアクセス可能です

建てる

Dockerビルド:

docker build -t mcp/zulip .

ライセンス

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