Zulip

🚀 Zulip MCP サーバー

Zulip の MCP（マシンコンテキストプロトコル）サーバーは、Zulip API をサポートし、Claude などの AI アシスタントが Zulip ワークスペースとやり取りできるようにします。

✨ 主な機能

1. zulip_list_channels

• 組織内の利用可能なチャンネル（ストリーム）をリストします。
• オプション入力:
  • include_private (boolean, デフォルト: false): プライベートストリームを含めるかどうか
  • include_web_public (boolean, デフォルト: true): ウェブ公開のストリームを含めるかどうか
  • include_subscribed (boolean, デフォルト: true): ボットがサブスクライブしているストリームを含めるかどうか
• 戻り値: ID と情報を含むストリームのリスト

2. zulip_post_message

• Zulip チャンネル（ストリーム）に新しいメッセージを投稿します。
• 必須入力:
  • channel_name (string): 投稿先のストリーム名
  • topic (string): ストリーム内のトピック
  • content (string): 投稿するメッセージ内容
• 戻り値: メッセージの投稿確認と ID

3. zulip_send_direct_message

• 1 人以上のユーザーに直接メッセージを送信します。
• 必須入力:
  • recipients (string[]): 受信者のメールアドレスまたはユーザー ID
  • content (string): 送信するメッセージ内容
• 戻り値: メッセージの送信確認と ID

4. zulip_add_reaction

• 特定のメッセージに絵文字リアクションを追加します。
• 必須入力:
  • message_id (number): 返信するメッセージの ID
  • emoji_name (string): コロンを含まない絵文字名
• 戻り値: リアクションの確認

5. zulip_get_channel_history

• チャンネル（ストリーム）とトピックから最近のメッセージを取得します。
• 必須入力:
  • channel_name (string): ストリーム名
  • topic (string): トピック名
• オプション入力:
  • limit (number, デフォルト: 20): 取得するメッセージの数
  • anchor (string, デフォルト: "newest"): 開始点のメッセージ ID
• 戻り値: 内容とメタデータを含むメッセージのリスト

6. zulip_get_topics

• チャンネル（ストリーム）内のトピックのリストを取得します。
• 必須入力:
  • channel_name (string): ストリーム名
• 戻り値: リアクションの確認

7. zulip_join_channel

• チャンネルに参加します。
• 必須入力:
  • channel_name (string): 参加するストリーム名
• 戻り値: チャンネル参加の確認

8. zulip_leave_channel

• チャンネルから退出します。
• 必須入力:
  • channel_name (string): 退出するストリーム名
• 戻り値: チャンネル退出の確認

📦 インストール

Zulip ボットの作成

1. あなたの Zulip 組織にログインします。
2. Zulip 管理 ページにアクセスします。
3. 「新しいボットを作成」ボタンをクリックします。
4. ボットの設定（ボット名やメールアドレスなど）を構成します。
5. API キーを生成し、記録します。

権限の設定

ボットが以下の権限を持っていることを確認してください。

• 読み取り権限: ボットがチャンネルの内容を表示できるようにします。
• 書き込み権限: ボットがメッセージを送信できるようにします。
• 管理権限（オプション）: ボットが他のユーザーやチャンネルを管理できるようにします。

💻 使用例

Claude Desktop との統合

npx で実行する場合

ターミナルで以下のコマンドを実行します。

npx mcp-server zulip --url YOUR_ZULIP_URL --token YOUR_API_KEY

Docker で実行する場合

イメージをビルドし、コンテナを実行します。

docker build -t mcp/zulip .
docker run -it --rm mcp/zulip --url YOUR_ZULIP_URL --token YOUR_API_KEY

設定例

npx 方法

claude_desktop_config.json ファイルを編集し、以下の内容を追加します。

{
  "mcpServers": [
    {
      "command": "npx",
      "args": ["mcp-server", "zulip"],
      "env": {
        "ZULIP_URL": "https://your-org.zulip.com",
        "ZULIP_TOKEN": "your_api_key_here"
      }
    }
  ]
}

Docker 方法

claude_desktop_config.json ファイルを編集し、以下の内容を追加します。

{
  "mcpServers": [
    {
      "command": "docker",
      "args": ["run", "-it", "--rm", "mcp/zulip"],
      "env": {
        "ZULIP_URL": "https://your-org.zulip.com",
        "ZULIP_TOKEN": "your_api_key_here"
      }
    }
  ]
}

🛠️ トラブルシューティング

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

1. API キーが正しいことを確認します。
2. ボットがアクセスする必要のあるチャンネルにサブスクライブしていることを確認します。
3. Zulip URL が正しく、アクセス可能であることを確認します。

🔨 ビルド

以下のコマンドを使用して Docker イメージをビルドします。

docker build -t mcp/zulip .

📄 ライセンス

この MCP サーバーは MIT ライセンスの下で配布されています。