mcgl-mcp 0.1.1 → 0.2.0

package/README.md

@@ -58,6 +58,8 @@ claude mcp add mcgl -e FORUM_LOGIN=ник -e FORUM_PASSWORD=пароль -- npx
 | `forum_list_topics`   | темы раздела: закреплённые, закрытые, кто может отвечать                             |
 | `forum_get_topic`     | посты темы по 15 штук; по умолчанию — последние, плюс опрос и кто читает тему сейчас |
 | `forum_get_post`      | один пост по ссылке `/post/N` и где он находится в теме                              |
+| `forum_find_users`    | игроки по началу ника                                                                |
+| `forum_user_topics`   | темы, созданные игроком (по нику или id)                                             |
 
 ## Настройки
 

package/dist/forum/objects.js

@@ -16,6 +16,28 @@ export function parseObjectLiteral(raw) {
     }
     return Object.keys(result).length ? result : undefined;
 }
+/**
+ * Ответ точного поиска игрока `/object/0/9?q=nick`: `[{'id':'714893','login':'pozziittiivo'}]`.
+ * Если игрока нет, форум отвечает `player$0` с id 0 — тогда undefined.
+ */
+export function parseUserExact(raw) {
+    const obj = parseObjectLiteral(raw.trim().replace(/^\[/, "").replace(/\]$/, ""));
+    const id = Number(obj?.id);
+    if (!obj?.login || !Number.isInteger(id) || id <= 0)
+        return undefined;
+    return { id, name: obj.login };
+}
+/**
+ * Ответ поиска по началу ника `/object/0/4?q=prefix`: строки `nick|group|id`.
+ * Пустые строки (`|guest|`) и удалённые аккаунты (`player$N`) отбрасываются.
+ */
+export function parseUserPrefix(raw) {
+    return raw
+        .split(/\r?\n/)
+        .map((line) => line.trim().split("|"))
+        .filter(([name, , id]) => name && !/^player\$\d+$/.test(name) && Number(id) > 0)
+        .map(([name, group, id]) => ({ id: Number(id), name, group: group || undefined }));
+}
 /** Маркер предмета в тексте поста, который ставит content.ts и раскрывает ItemResolver. */
 export const ITEM_TOKEN = /⟦item:(\d+):(\d+)⟧/g;
 export const itemToken = (id, meta) => `⟦item:${id}:${meta}⟧`;

package/dist/forum/reader.js

@@ -1,5 +1,5 @@
 import { ForumError } from "./errors.js";
-import { ItemResolver } from "./objects.js";
+import { ItemResolver, parseUserExact, parseUserPrefix } from "./objects.js";
 import { parseSections, parseTopicList } from "./parsers/topic-list.js";
 import { parsePostPage, parseTopicPage } from "./parsers/topic.js";
 import { site } from "./site.js";
@@ -48,6 +48,37 @@ export class ForumReader {
     async sectionTopics(sectionId, page = 1) {
         return this.rememberPages(parseTopicList(await this.get(site.section(sectionId, page)), page));
     }
+    /** Игроки, чей ник начинается с prefix (без учёта регистра). */
+    async findUsers(prefix, limit = 20) {
+        return parseUserPrefix((await this.http.get(site.userPrefix(prefix))).html).slice(0, limit);
+    }
+    /** Темы, созданные игроком. Игрок задаётся id или точным ником (регистр не важен). */
+    async userTopics(user, page = 1) {
+        let id = user.id;
+        if (id === undefined) {
+            const nick = user.nick?.trim() ?? "";
+            const found = nick ? parseUserExact((await this.http.get(site.userExact(nick))).html) : undefined;
+            if (!found) {
+                // Подсказки: ники с тем же началом; при опечатке в середине — по первым 4 буквам.
+                let prefix = nick;
+                let similar = nick ? await this.findUsers(nick, 10) : [];
+                if (similar.length === 0 && nick.length > 4) {
+                    prefix = nick.slice(0, 4);
+                    similar = await this.findUsers(prefix, 10);
+                }
+                throw new ForumError(`Player "${nick}" not found.` +
+                    (similar.length ? ` Nicks starting with "${prefix}": ${similar.map((u) => u.name).join(", ")}` : ""));
+            }
+            id = found.id;
+        }
+        const list = parseTopicList(await this.get(site.userTopics(id, page)), page);
+        if (list.topics.length === 0 && page > 1) {
+            throw new ForumError(`Player ${id} has fewer than ${page} pages of topics`);
+        }
+        // Заголовок страницы: «Темы пользователя <ник>».
+        const name = list.title?.replace(/^Темы пользователя\s+/, "") ?? user.nick ?? String(id);
+        return { ...this.rememberPages(list), user: { id, name } };
+    }
     /** page — от начала темы (с 1); без него — последние pageSize постов. */
     async topic(topicId, page, pageSize = DEFAULT_PAGE_SIZE) {
         try {

package/dist/forum/site.js

@@ -21,6 +21,12 @@ export const site = {
     topic: (topicId, page) => `/topic/${topicId}/${page - 1}`,
     /** Отдельный пост. */
     post: (postId) => `/post/${postId}`,
+    /** Темы игрока. В URL id игрока + 1 со знаком минус: игрок 714893 → /forum/-714894. */
+    userTopics: (userId, page) => `/forum/-${userId + 1}/${page - 1}`,
+    /** Точный поиск игрока по нику (без учёта регистра): [{'id':'714893','login':'nick'}], нет такого → player$0. */
+    userExact: (nick) => `/object/0/9?q=${encodeURIComponent(nick)}`,
+    /** Поиск игроков по началу ника: строки "nick|group|id". */
+    userPrefix: (prefix) => `/object/0/4?q=${encodeURIComponent(prefix)}`,
     /** Страница с формой логина: из неё берутся скрытые поля (form, ref, fcode, recap). */
     loginPage: () => "/guilogin/",
     /** Куда отправляется форма логина. Успех: 302 на ref, неудача: 302 на /guilogin/4?f=N. */

package/dist/mcp/tools/index.js

@@ -1,4 +1,5 @@
 import { readTools } from "./public/read.js";
+import { userTools } from "./public/users.js";
 /**
  * Реестр инструментов.
  *
@@ -6,6 +7,6 @@ import { readTools } from "./public/read.js";
  * `definePlayerTool(...)` и добавить в нужный массив.
  * Player-инструменты автоматически не попадают в HTTP-режим.
  */
-export const publicTools = [...readTools];
+export const publicTools = [...readTools, ...userTools];
 export const playerTools = [];
 //# sourceMappingURL=index.js.map

package/dist/mcp/tools/public/read.js

@@ -9,7 +9,7 @@ const FLAGS_NOTE = " Boolean flags appear only when true.";
 const page = z.number().int().positive().default(1).describe("1-based page number");
 const TOPIC_ROW_FIELDS = "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." +
+    "pages (topic page count); created/last: author and time; author.group is the player's privilege (paid or staff role, e.g. vip, platinum, admin); 'girls' is only a nick color anyone can pick, not gender." +
     FLAGS_NOTE;
 export const listSections = definePublicTool({
     name: "forum_list_sections",
@@ -48,7 +48,7 @@ export const getTopic = definePublicTool({
         "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. " +
+        "author.accountDeleted: account removed or banned; author.group is the player's privilege (paid or staff role, e.g. vip, platinum, admin); 'girls' is only a nick color anyone can pick, not gender. " +
         "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." +
         FLAGS_NOTE,

package/dist/mcp/tools/public/users.js

@@ -0,0 +1,35 @@
+import { z } from "zod";
+import { ForumError } from "../../../forum/errors.js";
+import { definePublicTool, jsonResult } from "../../define-tool.js";
+const readOnly = { readOnlyHint: true, openWorldHint: true };
+export const findUsers = definePublicTool({
+    name: "forum_find_users",
+    title: "Find players",
+    description: "Players whose nick starts with the given text (case-insensitive): name, id, group. " +
+        "group is the player's privilege (paid or staff role, e.g. vip, platinum, admin); 'girls' is only a nick color anyone can pick, not gender.",
+    inputSchema: {
+        prefix: z.string().trim().min(1).max(32).describe("Beginning of the nick"),
+        limit: z.number().int().min(1).max(50).default(20),
+    },
+    annotations: readOnly,
+    handler: async ({ prefix, limit }, { reader }) => jsonResult(await reader.findUsers(prefix, limit)),
+});
+export const userTopics = definePublicTool({
+    name: "forum_user_topics",
+    title: "Topics by player",
+    description: "Topics created by a player, newest first, same row format as forum_list_topics. " +
+        "Give nick (exact, case-insensitive) or userId. If the nick is unknown, the error lists similar nicks.",
+    inputSchema: {
+        nick: z.string().trim().min(1).max(32).optional(),
+        userId: z.number().int().positive().optional(),
+        page: z.number().int().positive().default(1).describe("1-based page number"),
+    },
+    annotations: readOnly,
+    handler: async ({ nick, userId, page }, { reader }) => {
+        if (!nick && !userId)
+            throw new ForumError("Pass nick or userId");
+        return jsonResult(await reader.userTopics({ id: userId, nick }, page));
+    },
+});
+export const userTools = [findUsers, userTopics];
+//# sourceMappingURL=users.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcgl-mcp",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "MCP server for the Minecraft Galaxy (MCGL) game forum: read sections, topics and posts.",
   "keywords": [
     "mcp",