Проект: /root/WORK/memo (Kotlin/JVM). Заказ по MCP-серверу. Контракт уже в docs/orders/07-mcp.md — читать его как исходное ТЗ, а здесь перечислены обязательные требования и известные грабли. Создать: memo-mcp/build.gradle.kts memo-mcp/src/main/kotlin/memo/mcp/McpServer.kt memo-mcp/src/test/kotlin/memo/mcp/McpProtocolTest.kt ## Зависимости модуля memo-mcp plugins { kotlin("jvm"); application; kotlin("plugin.serialization") version "2.4.10" } application { mainClass.set("memo.mcp.McpServerKt") } dependencies { implementation(project(":memo-core")) implementation("org.jetbrains.kotlinx:kotlinx-serialization-json:1.7.3") } ВАЖНО: в kotlin("plugin.serialization") версию указать обязательно 2.4.10, иначе сборка упадёт на несовместимости версий плагина и Kotlin. Если сериализация начнёт мешать — НЕ добавляй её, собери JSON строками вручную (ручной JSON-рендер допустим и проще). ## McpServer.kt fun main(args: Array) — читает stdin построчно, на каждый запрос печатает в stdout РОВНО одну строку JSON-RPC 2.0. В stdout НИЧЕГО кроме JSON (включая баннеры/логи) — диагностика только в stderr. Методы: - initialize → {"protocolVersion":"2024-11-05","capabilities":{"tools":{}},"serverInfo":{"name":"memo","version":"0.1.0"}} - notifications/initialized → ответ не отправлять (вернуть null) - tools/list → 3 инструмента: memo_search {path, query, k=8, mode="hybrid"}, memo_status {path}, memo_reindex {path} - tools/call {"name":..., "arguments":{...}} → {"content":[{"type":"text","text":"..."}],"isError":false} Ошибки (нет обязательного аргумента, неизвестный инструмент, исключение) → isError:true + текст, НЕ JSON-RPC error. - неизвестный метод → {"jsonrpc":"2.0","id":,"error":{"code":-32601,"message":"Method not found"}} - уведомление (нет "id" в запросе) → ответ не отправлять Тестируемые без процесса функции: handleRequest(line: String): String?, toolSearch(path, query, k, mode): String, toolStatus(path): String, toolReindex(path): String. Поведение инструментов: - Коллекции определять ТАК ЖЕ, как CLI: см. memo-cli/src/main/kotlin/memo/cli/Main.kt — переиспользуй ту логику определения корня и коллекций (если это private — сделай в memo-core отдельный файл memo-core/src/main/kotlin/memo/core/Collections.kt с функциями `fun resolveCollection(path: java.io.File): java.io.File` и `fun findCollections(root: java.io.File): List`, и переключи CLI и MCP на них; CLI при этом должен остаться с зелёными тестами). - toolSearch: Searcher с refresh-хуком (indexTree перед поиском), текст ответа — по строке на хит: `: ` и следом текст чанка; пусто → "ничего не найдено". - toolStatus: `<коллекция>: файлов , чанков , индекс `. - toolReindex: удалить `<коллекция>/.memo` целиком и переиндексировать; вернуть `переиндексировано файлов: `. ## McpProtocolTest.kt — ровно 5 тестов, имена ровно такие 1. `initializeHandshake` — ответ содержит "2024-11-05" и "memo". 2. `toolsListHasThreeTools` — ответ содержит memo_search, memo_status, memo_reindex. 3. `unknownMethodReturns32601` — ответ содержит "-32601". 4. `searchWithoutPathIsError` — tools/call memo_search с arguments {} → содержит "isError":true. 5. `notificationProducesNoResponse` — handleRequest(уведомление notifications/initialized) == null. После: ./gradlew :memo-mcp:test --rerun-tasks и ./gradlew :memo-mcp:installDist — зелёные. Коммит: git add -A && git commit -m "mcp: сервер memo_search/memo_status/memo_reindex" СТРОГИЕ ЗАПРЕТЫ: - Не выводить план текстом; сразу создавай файлы. - Не трогать логику memo-core, кроме добавления Collections.kt и переключения CLI на него. - Ничего в stdout, кроме JSON-RPC строк.