mcgl-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| LOG_LEVEL | No | Уровень логирования; `debug` включает подробные логи для отладки. | info |
| FORUM_LOGIN | No | Логин для входа под своим аккаунтом на форуме (необязательно). | |
| FORUM_BASE_URL | No | Адрес форума. | https://forum.minecraft-galaxy.ru |
| FORUM_PASSWORD | No | Пароль для входа под своим аккаунтом на форуме (необязательно). | |
| FORUM_TIMEOUT_MS | No | Таймаут одного запроса к форуму в миллисекундах. | 15000 |
| FORUM_MIN_INTERVAL_MS | No | Минимальная пауза между запросами к форуму в миллисекундах. | 300 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
Minecraft Galaxy (MCGL) game forum. Forum content is in Russian. Anything published to the forum on the user's behalf must be written in Russian unless the user explicitly asks otherwise.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| forum_list_sectionsA | Sections of the Minecraft Galaxy general forum (ids 1-11) grouped by category, with description, topic/reply counts and last post. Use the id with forum_list_topics. Content is in Russian. |
| forum_latest_topicsA | Recently active topics across all sections, newest first; each row includes its section name. Topic fields: pinned; closed (title struck through on the forum, no replies allowed); whoCanReply: all | vip | premium_platinum | moderators (only visible in topic lists, not on the topic page); pages (topic page count); created/last: author and time. Boolean flags appear only when true. |
| forum_list_topicsA | Topics of one section, pinned first, then by last activity. Section ids come from forum_list_sections. Topic fields: pinned; closed (title struck through on the forum, no replies allowed); whoCanReply: all | vip | premium_platinum | moderators (only visible in topic lists, not on the topic page); pages (topic page count); created/last: author and time. Boolean flags appear only when true. |
| forum_get_topicA | Posts of a topic. Without page: the newest pageSize posts (latest:true) - usually what is needed. With page: pages counted from the topic start, pageSize posts each (default 15); the page holding post #N is ceil(N/pageSize). Post numbers (#N) are continuous. Returns title, section, totalPages, totalPosts, posts (number, id, author, postedAt, text, rating; deleted posts are {deleted:true}). The latest view and page 1 also include poll (if any), notices (e.g. 'moved from section') and current readers. author.accountDeleted: account removed or banned. Post text markup: [quote: nick]..[/quote], [spoiler: title]..[/spoiler], [image: url], [video: url], [audio: url], [Item name #id] or [item #id] (#id:meta for variants), [craft] grid of item ids with a legend. Boolean flags appear only when true. |
| forum_get_postA | One post by id (e.g. from a /post/2120899 link) with its number in the topic, plus the topic and the forum_get_topic page (default pageSize) it is on. Same post format as forum_get_topic. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 5 tools
The tools form a clear hierarchy: sections, latest topics, section topics, topic posts, and a single post. Each tool has a distinct scope, and the descriptions explicitly explain how section ids and post ids flow between tools.
All tools use the forum_ prefix and mostly follow a verb_noun pattern (list_sections, list_topics, get_topic, get_post). forum_latest_topics is a minor deviation because it uses an adjective rather than a verb, but the overall convention is still predictable.
Five tools is well-scoped for a read-only forum browsing server. Each tool covers a distinct level of the content hierarchy and none feels redundant.
The surface covers browsing sections, recent topics, section topics, topic posts, and individual posts, which supports the main read-only workflow. A search tool for finding topics or posts by keyword is a notable but not fatal gap.