MS

monadical-sas/zulip-mcp

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る

12 stars 5 forks 品質 65 トレンド 8Apache-2.0

Zulip 用のモデルコンテキストプロトコルサーバ

概要

MCPの特長 Zulip API 用のサーバーで、Claude のような AI アシスタントが Zulip ワークスペースとやり取りできるようにします。 1. zulip list channels - Zulip 組織の利用可能なチャンネル (ストリーム) のリスト - オプションの入力: -include private (boolean、デフォルト: false): プライベートストリームを含むかどうか - include web public (boolean、デフォルト:true): ウェブ公開ストリームを含むかどうか -include subscribed(boolean、デフォルト:true): ボットが購読しているストリームを含むかどうか - リターン: 自分のIDと情報でストリームのリスト 2. zulip post message - Zulipチャンネル(ストリーム)に新しいメッセージを投稿 - 必須入力: - channel name(string): ストリームの名前を投稿する - トピック(string): ストリーム内のトピック - コンテンツ(文字列): 投稿するメッセージ内容 - 返送:メッセージ投稿確認とID 3.

概要(AI 翻訳)

MCPの特長 Zulip API 用のサーバーで、Claude のような AI アシスタントが Zulip ワークスペースとやり取りできるようにします。

ツール

  1. [zulip_list_channels]
  • Zulip組織の利用可能なチャンネル(ストリーム)のリスト
  • 任意入力:
  • [include_private] (ブーリアン、デフォルト: false): プライベートストリームを含むかどうか
  • [include_web_public (ブーリアン、デフォルト: true): ウェブ公開ストリームを含むかどうか
  • [include_subscribed] (ブーリアン、デフォルト:true): ボットが購読しているストリームを含むかどうか
  • 返品:IDと情報でストリームの一覧
  1. [zulip_post_message
  • Zulipチャンネルに新しいメッセージを投稿(ストリーム)
  • 必須入力:
  • channel_name (文字列): ストリームの名前を投稿する
  • [topic] (文字列): ストリーム内のトピック
  • content (文字列): 投稿するメッセージ内容
  • 返送:メッセージ投稿確認とID
  1. [zulip_send_direct_message
  • 1つ以上のユーザーにダイレクトメッセージを送信する
  • 必須入力:
  • [recipients] (string[]): 受信者のメールアドレスまたはユーザーID
  • [content (文字列): 送信するメッセージ内容
  • 返送:メッセージ送信確認とID
  1. [zulip_add_reaction
  • emoji 反応をメッセージに追加する

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。

README

以下は原文 README の抜粋です。原文を見る。

Zulip MCP Server

MCP Server for the Zulip API, enabling AI assistants like Claude to interact with Zulip workspaces.

Tools

  1. zulip_list_channels

    • List available channels (streams) in the Zulip organization
    • Optional inputs:
      • include_private (boolean, default: false): Whether to include private streams
      • include_web_public (boolean, default: true): Whether to include web-public streams
      • include_subscribed (boolean, default: true): Whether to include streams the bot is subscribed to
    • Returns: List of streams with their IDs and information
  2. zulip_post_message

    • Post a new message to a Zulip channel (stream)
    • Required inputs:
      • channel_name (string): The name of the stream to post to
      • topic (string): The topic within the stream
      • content (string): The message content to post
    • Returns: Message posting confirmation and ID
  3. zulip_send_direct_message

    • Send a direct message to one or more users
    • Required inputs:
      • recipients (string[]): Email addresses or user IDs of recipients
      • content (string): The message content to send
    • Returns: Message sending confirmation and ID
  4. zulip_add_reaction

    • Add an emoji reaction to a message
    • Required inputs:
      • message_id (number): The ID of the message to react to
      • emoji_name (string): Emoji name without colons
    • Returns: Reaction confirmation
  5. zulip_get_channel_history

    • Get recent messages from a channel (stream) and topic
    • Required inputs:
      • channel_name (string): The name of the stream
      • topic (string): The topic name
    • Optional inputs:
      • limit (number, default: 20): Number of messages to retrieve
      • anchor (string, default: “newest”): Message ID to start from
    • Returns: List of messages with their content and metadata
  6. zulip_get_topics

    • Get topics in a channel (stream)
    • Required inputs:
      • channel_id (number): The ID of the stream
    • Returns: List of topics in the stream
  7. zulip_subscribe_to_channel

    • Subscribe the bot to a channel (stream)
    • Required inputs:
      • channel_name (string): The name of the stream to subscribe to
    • Returns: Subscription confirmation
  8. zulip_get_users

    • Get list of users in the Zulip organization
    • Returns: List of users with their basic information

Setup

  1. Create a Zulip Bot:

    • Log in to your Zulip instance
    • Navigate to Settings > Personal > Bots
    • Click “Add a new bot”
    • Select “Generic bot” type
    • Fill in the required information
    • Click “Create bot”
  2. Permissions:

    • By default, Zulip bots have limited permissions
    • Make sure to subscribe the bot to any streams it needs to access
    • If you need the bot to have more permissions, consider using a full user account instead
  3. Get the API credentials:

    • Bot’s email address
    • Bot’s API key (displayed when you create the bot)
GitHub で README 全文を見る

インストール

npx -y @modelcontextprotocol/server-zulip
MCP 初心者?mcpskill.org のガイドから始めましょう →

設定

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