@mentionable bots로 Zulip에서 AI 대리인을 실행하십시오 - 또는 어떤 MCP 클라이언트로 철사. 또한 Python 라이브러리로 작동합니다.

퀵스타트

1. 패키지를 설치:

2. Zulip bot credentials와 프로젝트 루트에 .zuliprc 파일을 추가하십시오. 봇을 추가하거나 봇을 만들기에 대한 지침을 통합하십시오. 봇 타입은 "일반"이어야 합니다.

3. MCP 서버를 .mcp.json에 추가하십시오:

4. MCP 클라이언트를 재시작하십시오. Zulip 도구는 이제 사용할 수 있어야합니다.

요구 사항

• Python >=3.10, uv로 관리
• A .zuliprc Zulip API auth 파일 (Quickstart 참조)
• 청취자 모드 : 선택된 백엔드 CLI 설치 및 인증 ([claude] 기본으로 codex], 또는 opencode])

입력 점수

| 입장 포인트 | Description | |—||| | uv run python -m zulipmcp.mcp | MCP 서버 클로드 코드, 코덱 및 기타 MCP 클라이언트 | | uv run python -m zulipmcp.mcp --transport sse | MCP 서버 이상 SSE(리모/웹 클라이언트용) | | uv run python -m zulipmcp.launch_agent | 청취자 없이 MCP-backed 코딩 세션을 시작 | | uv run python -m zulipmcp.listener | 인스트럭터: @mentions, spawns Agent sessions |

도서관 사용법

zulipmcp

Run AI agents in Zulip as @mentionable bots — or wire into any MCP client. Also works as a Python library.

Quickstart

1. Install the package:

   uv add zulipmcp --git https://github.com/windborne/zulipmcp.git
   

2. Add a .zuliprc file to your project root with your Zulip bot credentials. See Add a bot or integration for instructions on making a bot. The bot type must be “generic.”

3. Add the MCP server to your .mcp.json:

   {
     "mcpServers": {
       "zulip": {
         "command": "uv",
         "args": ["run", "python", "-m", "zulipmcp.mcp"]
       }
     }
   }
   

4. Restart your MCP client. The Zulip tools should now be available.

Requirements

• Python >=3.10, managed with uv
• A .zuliprc file for Zulip API auth (see Quickstart)
• For listener mode: the selected backend CLI installed and authenticated (claude by default, codex with --backend codex, or opencode with --backend opencode)

Entry Points

Library Usage

zulipmcp can also be imported directly as a Python library:

import zulipmcp

# Fetch and format recent messages
messages = zulipmcp.get_messages(hours_back=24, channels=["engineering"])
print(zulipmcp.format_messages(messages))

# Send a message
zulipmcp.send_message("engineering", "general", "Hello from Python!")

# Configure MCP hooks before starting the server
zulipmcp.configure(
    message_prefix=lambda: "[bot] ",
    on_session_end=lambda session: print(f"Session ended in #{session.stream}"),
)

Hermes Gateway

Hermes uses the native hermes_plugin/zulip gateway adapter instead of the subprocess listener. Each stream/topic maps to its own persistent Hermes session, while zulipmcp remains available as the explicit Zulip API tool layer.

• Mention the bot once to activate a topic; follow-ups do not need a mention.
• Each user message is a fresh Hermes turn with a fresh iteration budget.
• Typing, normal response delivery, status reactions, approval reactions,