MCP-сервер для сервисов Яндекс 360 (Вики и далее) — инструменты для AI-ассистентов.
Server has 9 well-named tools with consistent verb_noun patterns (wiki_get_page, wiki_create_page, wiki_delete_page). All tools have descriptions in Russian (10-200 chars, within baseline range). Input schemas are present with type definitions and parameter descriptions. Tool annotations (readOnlyHint, destructiveHint) are correctly applied. However, output schemas are not documented, LLMs cannot predict response structure for chaining. Error handling is minimal; no recovery guidance or actionable error messages visible in code. Parameter descriptions lack format constraints (e.g., slug pattern, content encoding). No pagination documented for wiki_tree and wiki_search despite returning lists.
Дописать content (YFM) в конец страницы, не затрагивая существующий текст.
Создать страницу. title — заголовок, slug — адрес (напр. 'razrabotka/notes'), content — тело в формате YFM. Родитель определяется префиксом slug.
Удалить страницу по id. Действие деструктивное — сначала уточни у пользователя.
Получить страницу по её slug (адресу, напр. 'homepage' или 'razrabotka/deploy'). with_content=True добавляет тело страницы в формате YFM (поле content).
Получить страницу по числовому id. with_content=True — вернуть тело (YFM).
Полнотекстовый поиск по страницам вики. Возвращает совпадения с id и slug.
Output schemas not documented. LLMs cannot predict response structure (fields, types, pagination) for wiki_tree, wiki_search, wiki_get_page. This breaks tool chaining, agent cannot extract page_id from search results to pass to wiki_update_page without guessing response format.
Pagination not documented for list-returning tools (wiki_tree, wiki_search). No mention of total count, next_cursor, or result limits. Large result sets risk context window exhaustion. Baseline pattern requires pagination with limit/offset and total count.
Error handling absent from visible code. No recovery guidance, error classification, or actionable messages. If wiki_create_page fails (e.g., slug already exists), LLM receives raw HTTP error with no next-step guidance.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 60 | 2026-07-28+ | v2 |
Дерево страниц: все потомки страницы с данным slug (для навигации по вики). По умолчанию — от корневой 'homepage'. Личные разделы пользователей — slug 'users'.
Обновить страницу по id. Передавай только то, что меняешь: title и/или content (YFM). ВНИМАНИЕ: content полностью ЗАМЕНЯЕТ текущее тело страницы. Чтобы дописать в конец, используй wiki_append_content. Перед заменой разумно сначала прочитать текущий content.
Кто я: данные текущего пользователя API Вики (проверка доступа).
Parameter format constraints missing. 'slug' parameter lacks pattern (e.g., 'homepage' or 'razrabotka/deploy', alphanumeric + slash?). 'content' (YFM format) has no encoding or length constraints. LLMs may pass invalid slugs or oversized content.
wiki_update_page description warns about destructive replacement but lacks confirmation/dry-run pattern. Agents may accidentally overwrite page content. Pattern recommends confirmation step for irreversible operations.