Traditional Chinese (zh-TW) Taiwan Community Forum
Read-only MCP: search & read a Traditional Chinese (zh-TW) Taiwan community forum (PTT-style).
Open source Repository Open in the app JSON README (API)
About
Read-only MCP: search & read a Traditional Chinese (zh-TW) Taiwan community forum (PTT-style).
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- shuaigle
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 1.18.0
- Last push
- 2026-07-18T00:00:32Z
- Repository state
- ativo
- Added
- 2026-08-29 03:02:15
- Updated
- 2026-08-29 03:02:15
- Origin id
io.github.Shuaigle/roomnology-forum
README
# Roomnology Forum MCP Server
Read-only [Model Context Protocol](https://modelcontextprotocol.io) server for the
[Roomnology](https://roomnology.com) community forum — a Traditional Chinese (zh-TW)
online forum focused on Taiwan.
繁體中文台灣社群論壇的唯讀 MCP server。
- **Registry name**: `io.github.Shuaigle/roomnology-forum`
- **Endpoint**: `https://api.roomnology.com/mcp` (streamable HTTP, stateless, anonymous — no API key required)
- **Access**: read-only; rate limited
- **Privacy policy**: <https://roomnology.com/privacy/mcp>
- **Contact / takedown requests**: <support@roomnology.com>
## What's inside
A PTT-style community forum with boards for news, sharing, and user-created personal
boards. Its largest collection is a news board of digests of popular Taiwanese
discussion, primarily from late 2025 to early 2026 and no longer updated; other boards
carry lighter community activity. Useful for exploring Taiwanese online discussion,
popular topics, and colloquial Traditional Chinese.
## Tools
| Tool | Description |
|---|---|
| `list_forums` | List all boards and sub-boards. Call first to discover board names. |
| `search_forum` | Keyword search over published articles (title + body, case-insensitive). Use Traditional Chinese keywords for best results. |
| `list_articles` | List published articles — by board (`forumName` + `subForumName`), or site-wide sorted by `LATEST` / `HOT`. |
| `get_article` | Get a single published article with full content, by article id (UUID). |
| `list_comments` | List the comments/replies on an article, paginated. |
## Try it
Claude Code:
```bash
claude mcp add --transport http roomnology-forum https://api.roomnology.com/mcp
```
Generic MCP client config:
```json
{
"mcpServers": {
"roomnology-forum": {
"type": "streamable-http",
"url": "https://api.roomnology.com/mcp"
}
}
}
```
## About this repository
This repository is the public home of the MCP server: registry metadata
([`server.json`](server.json)) and documentation. The server implementation lives in a
private backend codebase (Spring Boot + Spring AI MCP); the forum's read logic is shared
with the public REST API that powers <https://roomnology.com>.
Content note: forum articles may quote or excerpt third-party sources with attribution
links. For any rights concern, email <support@roomnology.com> and the content will be
reviewed and taken down promptly.