Rocket.Chat Threads MCP

English | 한국어 | 日本語 | 中文

Recommended: For full Korean/Japanese/Chinese search support, use with rocketchat-enhanced - Rocket.Chat + OpenSearch + MCP Proxy in one Docker package.

---

English

MCP (Model Context Protocol) server for Rocket.Chat with full thread support - search, list, and retrieve thread discussions.

Why This MCP?

Unlike basic chat integrations, this MCP focuses on thread-based conversations:

Feature	Basic MCP	Threads MCP
Thread Support	No	Full (list/get/search)
Search Thread Replies	No	Yes
Time Filtering	No	1d, 7d, 1w, 1m
Auth Method	Password	Token (secure)
Write Protection	Always on	Off by default
@all Prevention	No	Auto-blocked
Rate Limiting	No	Yes
Unit Tests	No	231 tests

Features

• Thread-Centric: Threads as the unit of discussions and decisions
• Deep Search: Search within thread replies, not just parent messages
• Time Filtering: Filter by 1d, 7d, 1w, 1m or date ranges
• Safe Writes: Disabled by default, @mentions auto-neutralized
• Type-Safe: Full TypeScript with Zod validation

Installation

Via npm (Recommended):

npm install -g mcp-server-rocketchat-threads

From source:

git clone https://github.com/huiseo/rocketchat-threads-mcp.git
cd rocketchat-threads-mcp
npm install
npm run build

Configuration

ROCKETCHAT_URL=https://your-rocketchat-server.com
ROCKETCHAT_AUTH_TOKEN=your-auth-token
ROCKETCHAT_USER_ID=your-user-id

# Optional: Enable writes (disabled by default)
ROCKETCHAT_WRITE_ENABLED=true
ROCKETCHAT_WRITE_ROOMS=general,dev-team

Claude Desktop Setup

Add to ~/.config/claude/claude_desktop_config.json:

{
  "mcpServers": {
    "rocketchat": {
      "command": "node",
      "args": ["/path/to/rocketchat-threads-mcp/dist/index.js"],
      "env": {
        "ROCKETCHAT_URL": "https://your-server.com",
        "ROCKETCHAT_AUTH_TOKEN": "your-token",
        "ROCKETCHAT_USER_ID": "your-user-id"
      }
    }
  }
}

Available Tools

Tool	Description
rocketchat_list_channels	List accessible channels
rocketchat_search_channels	Search channels by name
rocketchat_get_channel_info	Get channel details
rocketchat_get_messages	Get messages with time filtering
rocketchat_search_messages	Search message content
rocketchat_get_message	Get specific message
rocketchat_list_threads	List threads in channel
rocketchat_get_thread	Get thread with all replies
rocketchat_search_threads	Search within thread replies
rocketchat_lookup_user	Find user info
rocketchat_list_users	List users
rocketchat_get_me	Get current user
rocketchat_send_message	Send message (opt-in)
rocketchat_react	Add reaction (opt-in)
rocketchat_get_write_status	Check write permissions

Optional: OpenSearch Integration

This MCP works with or without OpenSearch on your Rocket.Chat server:

Feature	Without OpenSearch	With OpenSearch
Channel-specific search	✅ Works	✅ Works
Global search (no roomId)	❌ Requires roomId	✅ Works
Search highlighting	❌	✅ <mark> tags
Multi-language search (Korean, Japanese, Chinese)	❌ Limited	✅ Full support

How to check: Try rocketchat_search_messages without roomId. If it works, OpenSearch is enabled.

For server administrators: To enable OpenSearch with Docker, see rocketchat-enhanced - a single Docker package with RocketChat + OpenSearch + real-time indexing.

Using MCP Proxy for OpenSearch

If your server has MCP Proxy configured for OpenSearch integration, use the proxy endpoint instead of the direct RocketChat URL:

# Direct RocketChat (limited search, no CJK language support)
ROCKETCHAT_URL=https://your-rocketchat-server.com

# Via MCP Proxy (full OpenSearch support, Korean/Japanese/Chinese search)
ROCKETCHAT_URL=https://your-rocketchat-server.com/mcp-api

Benefits of MCP Proxy:

• ✅ Full-text search with Korean, Japanese, Chinese support (Nori analyzer)
• ✅ Global search across all channels without roomId
• ✅ Search result highlighting with <mark> tags
• ✅ Automatic fallback to RocketChat API if OpenSearch unavailable

---

한국어

Rocket.Chat용 MCP (Model Context Protocol) 서버 - AI 에이전트가 스레드, 토론, 결정 사항에서 조직 지식을 검색할 수 있게 합니다.

왜 이 MCP인가?

기본 채팅 연동과 달리, 이 MCP는 지식 검색에 초점을 맞춥니다:

기능	기본 MCP	Knowledge MCP
스레드 지원	없음	완전 지원
스레드 답글 검색	없음	지원
시간 필터링	없음	1d, 7d, 1w, 1m
인증 방식	비밀번호	토큰 (보안)
쓰기 보호	항상 켜짐	기본 꺼짐
@all 차단	없음	자동 차단
속도 제한	없음	지원
유닛 테스트	없음	231개

주요 기능

• 스레드 중심: 토론과 결정의 단위로서의 스레드
• 심층 검색: 부모 메시지뿐 아니라 스레드 답글 내 검색
• 시간 필터링: 1d, 7d, 1w, 1m 또는 날짜 범위로 필터
• 안전한 쓰기: 기본 비활성화, @멘션 자동 중화
• 타입 안전: Zod 검증을 포함한 완전한 TypeScript

설치

npm으로 설치 (권장):

npm install -g mcp-server-rocketchat-threads

소스에서 설치:

git clone https://github.com/huiseo/rocketchat-threads-mcp.git
cd rocketchat-threads-mcp
npm install
npm run build

설정

ROCKETCHAT_URL=https://your-rocketchat-server.com
ROCKETCHAT_AUTH_TOKEN=your-auth-token
ROCKETCHAT_USER_ID=your-user-id

# 선택: 쓰기 활성화 (기본 비활성화)
ROCKETCHAT_WRITE_ENABLED=true
ROCKETCHAT_WRITE_ROOMS=general,dev-team

선택사항: OpenSearch 연동

이 MCP는 Rocket.Chat 서버에 OpenSearch가 있든 없든 작동합니다:

기능	OpenSearch 없이	OpenSearch 있음
채널별 검색	✅ 작동	✅ 작동
전역 검색 (roomId 없이)	❌ roomId 필요	✅ 작동
검색 하이라이팅	❌	✅ <mark> 태그
한글/일본어/중국어 검색	❌ 제한적	✅ 완전 지원

확인 방법: roomId 없이 rocketchat_search_messages를 실행해보세요. 작동하면 OpenSearch가 활성화된 것입니다.

서버 관리자용: Docker로 OpenSearch를 활성화하려면 rocketchat-enhanced를 참조하세요 - RocketChat + OpenSearch + 실시간 인덱싱이 포함된 단일 Docker 패키지입니다.

MCP Proxy를 통한 OpenSearch 사용

서버에 OpenSearch 연동을 위한 MCP Proxy가 구성되어 있다면, RocketChat 직접 URL 대신 프록시 엔드포인트를 사용하세요:

# RocketChat 직접 연결 (검색 제한, 한글 검색 미지원)
ROCKETCHAT_URL=https://your-rocketchat-server.com

# MCP Proxy 경유 (OpenSearch 전체 지원, 한글 검색 지원)
ROCKETCHAT_URL=https://your-rocketchat-server.com/mcp-api

MCP Proxy의 장점:

• ✅ 한글, 일본어, 중국어 전문 검색 지원 (Nori 분석기)
• ✅ roomId 없이 전체 채널 전역 검색
• ✅ <mark> 태그를 사용한 검색 결과 하이라이팅
• ✅ OpenSearch 사용 불가 시 RocketChat API로 자동 폴백

---

日本語

Rocket.Chat用MCP（Model Context Protocol）サーバー - AIエージェントがスレッド、議論、決定事項から組織知識を検索できるようにします。

なぜこのMCPか？

基本的なチャット連携とは異なり、このMCPは知識検索に焦点を当てています：

機能	基本MCP	Knowledge MCP
スレッドサポート	なし	完全対応
スレッド返信検索	なし	対応
時間フィルタリング	なし	1d, 7d, 1w, 1m
認証方式	パスワード	トークン（安全）
書き込み保護	常にオン	デフォルトオフ
@all ブロック	なし	自動ブロック
レート制限	なし	対応
ユニットテスト	なし	231件

主な機能

• スレッド中心: 議論と決定の単位としてのスレッド
• 深層検索: 親メッセージだけでなくスレッド返信内を検索
• 時間フィルタリング: 1d、7d、1w、1mまたは日付範囲でフィルタ
• 安全な書き込み: デフォルト無効、@メンション自動無効化
• 型安全: Zodバリデーションを含む完全なTypeScript

インストール

npmでインストール（推奨）:

npm install -g mcp-server-rocketchat-threads

ソースからインストール:

git clone https://github.com/huiseo/rocketchat-threads-mcp.git
cd rocketchat-threads-mcp
npm install
npm run build

オプション: OpenSearch連携

このMCPはRocket.ChatサーバーのOpenSearchの有無にかかわらず動作します：

機能	OpenSearchなし	OpenSearchあり
チャンネル別検索	✅ 動作	✅ 動作
グローバル検索（roomIdなし）	❌ roomId必須	✅ 動作
検索ハイライト	❌	✅ <mark>タグ
韓国語/日本語/中国語検索	❌ 制限あり	✅ 完全対応

確認方法: roomIdなしでrocketchat_search_messagesを実行してみてください。動作すればOpenSearchが有効です。

サーバー管理者向け: DockerでOpenSearchを有効にするには、rocketchat-enhancedを参照してください - RocketChat + OpenSearch + リアルタイムインデックスを含む単一Dockerパッケージです。

MCP ProxyによるOpenSearch使用

サーバーにOpenSearch連携用のMCP Proxyが設定されている場合、RocketChatの直接URLの代わりにプロキシエンドポイントを使用してください：

# RocketChat直接接続（検索制限、日本語検索非対応）
ROCKETCHAT_URL=https://your-rocketchat-server.com

# MCP Proxy経由（OpenSearch完全対応、日本語検索対応）
ROCKETCHAT_URL=https://your-rocketchat-server.com/mcp-api

MCP Proxyの利点:

• ✅ 韓国語、日本語、中国語の全文検索対応（Noriアナライザー）
• ✅ roomIdなしで全チャンネルのグローバル検索
• ✅ <mark>タグによる検索結果ハイライト
• ✅ OpenSearch利用不可時はRocketChat APIへ自動フォールバック

---

中文

Rocket.Chat的MCP（Model Context Protocol）服务器 - 使AI代理能够从线程、讨论和决策中检索组织知识。

为什么选择这个MCP？

与基本聊天集成不同，这个MCP专注于知识检索：

功能	基本MCP	Knowledge MCP
线程支持	无	完全支持
搜索线程回复	无	支持
时间过滤	无	1d, 7d, 1w, 1m
认证方式	密码	令牌（安全）
写入保护	始终开启	默认关闭
@all 阻止	无	自动阻止
速率限制	无	支持
单元测试	无	231个

主要功能

• 线程中心: 将线程作为讨论和决策的单位
• 深度搜索: 不仅搜索父消息，还搜索线程回复
• 时间过滤: 按1d、7d、1w、1m或日期范围过滤
• 安全写入: 默认禁用，@提及自动中和
• 类型安全: 包含Zod验证的完整TypeScript

安装

通过npm安装（推荐）:

npm install -g mcp-server-rocketchat-threads

从源码安装:

git clone https://github.com/huiseo/rocketchat-threads-mcp.git
cd rocketchat-threads-mcp
npm install
npm run build

可选：OpenSearch集成

此MCP无论Rocket.Chat服务器是否有OpenSearch都可以工作：

功能	无OpenSearch	有OpenSearch
频道内搜索	✅ 可用	✅ 可用
全局搜索（无roomId）	❌ 需要roomId	✅ 可用
搜索高亮	❌	✅ <mark>标签
韩语/日语/中文搜索	❌ 有限	✅ 完全支持

检查方法： 不带roomId运行rocketchat_search_messages。如果可以运行，说明OpenSearch已启用。

服务器管理员： 要使用Docker启用OpenSearch，请参阅rocketchat-enhanced - 包含RocketChat + OpenSearch + 实时索引的单一Docker包。

通过MCP Proxy使用OpenSearch

如果您的服务器已配置用于OpenSearch集成的MCP Proxy，请使用代理端点而不是直接的RocketChat URL：

# 直接连接RocketChat（搜索受限，不支持中文搜索）
ROCKETCHAT_URL=https://your-rocketchat-server.com

# 通过MCP Proxy（完全支持OpenSearch，支持中文搜索）
ROCKETCHAT_URL=https://your-rocketchat-server.com/mcp-api

MCP Proxy的优势：

• ✅ 支持韩语、日语、中文全文搜索（Nori分析器）
• ✅ 无需roomId即可全局搜索所有频道
• ✅ 使用<mark>标签高亮搜索结果
• ✅ OpenSearch不可用时自动回退到RocketChat API

---

Architecture

src/
├── index.ts              # Entry point
├── server.ts             # MCP server setup
├── tools/                # Tool definitions
│   ├── base.ts           # Type-safe tool registry
│   ├── channel-tools.ts
│   ├── message-tools.ts
│   ├── thread-tools.ts
│   ├── user-tools.ts
│   └── write-tools.ts
├── api/                  # Rocket.Chat API
│   ├── client.ts
│   ├── types.ts
│   └── schemas.ts        # Zod validation
├── guards/               # Safety guards
│   ├── write-guard.ts
│   ├── sanitizer.ts
│   ├── input-validator.ts
│   └── rate-limiter.ts
└── utils/
    ├── cache.ts
    ├── time-parser.ts
    └── token-counter.ts

Development

npm install      # Install dependencies
npm run dev      # Development mode
npm run build    # Build
npm test         # Run 231 tests
npm run lint     # Lint

Related Projects

rocketchat-enhanced

For the best experience with this MCP, we recommend using rocketchat-enhanced:

• Rocket.Chat + OpenSearch + MCP Proxy in one Docker package
• Real-time message indexing to OpenSearch
• Full CJK (Korean/Japanese/Chinese) search support with Nori analyzer
• Global search across all channels without roomId
• Search result highlighting with <mark> tags

# Quick start with Docker
git clone https://github.com/huiseo/rocketchat-enhanced.git
cd rocketchat-enhanced
docker-compose up -d

License

MIT License - see LICENSE for details.

Acknowledgments

• MCP (Model Context Protocol)
• Rocket.Chat API
• rocketchat-enhanced - OpenSearch integration for Rocket.Chat