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.

$3

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 |

$3

- 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

$3

Via npm (Recommended):
``bash
npm install -g mcp-server-rocketchat-threads
`

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

$3

`env
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
`

$3

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

`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"
}
}
}
}
`

$3

| 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 |

$3

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 | ❌ | ✅ 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.

$3

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

`env


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 tags
- ✅ Automatic fallback to RocketChat API if OpenSearch unavailable

---

한국어

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

$3

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

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

$3

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

$3

npm으로 설치 (권장):
`bash
npm install -g mcp-server-rocketchat-threads
`

소스에서 설치:
`bash
git clone https://github.com/huiseo/rocketchat-threads-mcp.git
cd rocketchat-threads-mcp
npm install
npm run build
`

$3

`env
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
`

$3

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

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

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

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

$3

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

`env


RocketChat 직접 연결 (검색 제한, 한글 검색 미지원)

ROCKETCHAT_URL=https://your-rocketchat-server.com

MCP Proxy 경유 (OpenSearch 전체 지원, 한글 검색 지원)

ROCKETCHAT_URL=https://your-rocketchat-server.com/mcp-api
`

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

---

日本語

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

$3

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

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

$3

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

$3

npmでインストール（推奨）:
`bash
npm install -g mcp-server-rocketchat-threads
`

ソースからインストール:
`bash
git clone https://github.com/huiseo/rocketchat-threads-mcp.git
cd rocketchat-threads-mcp
npm install
npm run build
`

$3

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

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

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

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

$3

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

`env


RocketChat直接接続（検索制限、日本語検索非対応）

ROCKETCHAT_URL=https://your-rocketchat-server.com

MCP Proxy経由（OpenSearch完全対応、日本語検索対応）

ROCKETCHAT_URL=https://your-rocketchat-server.com/mcp-api
`

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

---

中文

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

$3

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

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

$3

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

$3

通过npm安装（推荐）:
`bash
npm install -g mcp-server-rocketchat-threads
`

从源码安装:
`bash
git clone https://github.com/huiseo/rocketchat-threads-mcp.git
cd rocketchat-threads-mcp
npm install
npm run build
`

$3

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

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

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

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

$3

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

`env


直接连接RocketChat（搜索受限，不支持中文搜索）

ROCKETCHAT_URL=https://your-rocketchat-server.com

通过MCP Proxy（完全支持OpenSearch，支持中文搜索）

ROCKETCHAT_URL=https://your-rocketchat-server.com/mcp-api
`

MCP Proxy的优势：
- ✅ 支持韩语、日语、中文全文搜索（Nori分析器）
- ✅ 无需roomId即可全局搜索所有频道
- ✅ 使用标签高亮搜索结果
- ✅ 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

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

Related Projects

$3

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 tags

`bash


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