Merge branch 'release/0.2.2'

Author: alkoleft

.github/workflows/release.yml

@@ -83,31 +83,10 @@ jobs:
           body: |
             ## 🚀 MCP BSL Context Server ${{ steps.tag_version.outputs.VERSION }}
             
-            ### 📦 Artifacts
-            - JAR artifact published to GitHub Packages
-            - Docker images available for both SSE and STDIO modes
-            
             ### 🔄 Changes
             - Automatic release from tag ${{ steps.tag_version.outputs.VERSION }}
             
-            ### 📥 Installation
-            ```bash
-            # Using GitHub Packages
-            gradle dependency: 'ru.alkoleft:mcp-bsl-context:${{ steps.tag_version.outputs.VERSION_NUMBER }}'
-            
-            # Using Docker
-            docker pull ghcr.io/${{ github.repository }}:${{ steps.tag_version.outputs.VERSION_NUMBER }}
-            ```
-            
-            ### 🏃‍♂️ Usage
-            ```bash
-            # SSE Mode
-            java -jar mcp-bsl-context-${{ steps.tag_version.outputs.VERSION_NUMBER }}.jar --server.port=3000
-            
-            # STDIO Mode  
-            java -jar mcp-bsl-context-${{ steps.tag_version.outputs.VERSION_NUMBER }}.jar --mcp.transport=stdio
-            ```
-          draft: false
+          draft: true
           prerelease: false
           files: |
             ./build/libs/mcp-bsl-context-${{ steps.tag_version.outputs.VERSION_NUMBER }}.jar

README.md

@@ -1,18 +1,18 @@
-# MCP сервер для API платформы 1С Предприятие
+# MCP сервер для AI-ассистентов (справка по синтаксису и объектной модели 1С:Предприятие)
 
-**MCP (Model Context Protocol) сервер** предоставляющий стандартизированный доступ к API платформы 1С:Предприятие для AI ассистентов, таких как Claude Desktop и Cursor IDE.
+**MCP (Model Context Protocol) сервер** — это инструмент для интеграции с AI-ассистентами (например, Claude Desktop, Cursor IDE), предоставляющий быстрый и стандартизированный доступ к справочной информации по встроенным функциям, типам данных, методам и свойствам платформы 1С:Предприятие. MCP сервер позволяет AI-ассистентам работать с "Синтаксис-помощником" 1С в интерактивном режиме.
 
 ## Обзор
 
-Приложение `mcp-bsl-context` предназначено для разработчиков, работающих с языком BSL (Business Specific Language) и экосистемой 1С:Предприятие. Оно предоставляет интерактивный MCP сервер, который позволяет AI ассистентам выполнять поиск по документации платформы и получать детальную информацию об элементах API в реальном времени.
+Приложение `mcp-bsl-context` предназначено исключительно для интеграции с AI-ассистентами, чтобы они могли выполнять поиск по справке платформы 1С:Предприятие и получать детальную информацию о встроенных функциях, типах, методах и свойствах (аналогично работе с "Синтаксис-помощником" или официальной документацией 1С).
 
 ### 🤖 Возможности MCP сервера
 
-- **Поиск по API платформы** - нечеткий поиск по глобальным методам, свойствам и типам данных
-- **Детальная информация** - получение полной информации об элементах API с сигнатурами и описаниями  
-- **Информация об элементах типов** - получение методов и свойств конкретных типов данных
-- **Конструкторы типов** - информация о способах создания объектов
-- **Интеграция с AI** - стандартизированный доступ для AI ассистентов через MCP протокол
+- **Поиск по справке платформы 1С** — нечеткий поиск по встроенным функциям, методам, свойствам и типам данных
+- **Детальная справка** — получение подробной информации о функциях, методах, свойствах и типах, включая сигнатуры и описания
+- **Навигация по объектной модели** — просмотр методов и свойств конкретных типов данных
+- **Информация о конструкторах** — способы создания объектов платформы 1С
+- **Интеграция с AI** — стандартизированный протокол MCP для взаимодействия с AI-ассистентами
 
 Проект использует Spring Boot и Spring AI для создания MCP сервера на базе Kotlin.
 
@@ -52,18 +52,29 @@
 ### Запуск MCP сервера
 
 ```bash
-java -jar mcp-bsl-context-<версия>.jar --platform-path <путь_к_платформе_1С>
+java -jar mcp-bsl-context-<версия>.jar [опции]
 ```
 
-**Параметры:**
+**Опции:**
 
-- `--platform-path` (обязательный) - путь к каталогу установки 1С Предприятия
+- `--platform-path`, `-p` - путь к каталогу установки 1С Предприятия
+- `--help`, `-h` - показать справку по использованию
 - `--verbose` - включить отладочное логирование
 
-**Пример:**
+**Примеры:**
 
 ```bash
+# Основной способ запуска
 java -jar mcp-bsl-context-0.2.0.jar --platform-path "/opt/1cv8/x86_64/8.3.25.1257"
+
+# Сокращенная форма
+java -jar mcp-bsl-context-0.2.0.jar -p "/opt/1cv8/x86_64/8.3.25.1257"
+
+# Показать справку
+java -jar mcp-bsl-context-0.2.0.jar --help
+
+# С дополнительными Spring Boot параметрами
+java -jar mcp-bsl-context-0.2.0.jar --platform-path "/opt/1cv8/x86_64/8.3.25.1257" --server.port=8080
 ```
 
 ### Возможности MCP сервера

build.gradle.kts

@@ -13,7 +13,7 @@ plugins {
 }
 
 group = "io.github.alkoleft"
-version = "0.2.0-SNAPSHOT"
+version = "0.2.2-SNAPSHOT"
 
 gitVersioning.apply {
     refs {
@@ -37,6 +37,12 @@ kotlin {
     }
 }
 
+java {
+    toolchain {
+        languageVersion = JavaLanguageVersion.of(17)
+    }
+}
+
 repositories {
     mavenCentral()
     mavenLocal()
@@ -98,7 +104,7 @@ tasks.jar {
 tasks.bootJar {
     enabled = true
     archiveClassifier.set("")
-    mainClass.set("ru.alkoleft.context.platform.McpServerApplication")
+    mainClass.set("ru.alkoleft.context.McpServerApplicationKt")
 }
 
 // Исправление зависимостей для задач распространения

documentation/MCP_SERVER_USAGE.md

@@ -1,39 +1,39 @@
-# MCP сервер для API платформы 1С Предприятие
+# MCP сервер для AI-ассистентов (справка по синтаксису и объектной модели 1С:Предприятие)
 
 ## Описание
 
-MCP (Model Context Protocol) сервер предоставляет стандартизированный доступ к API платформы 1С Предприятие для AI ассистентов. Сервер поддерживает поиск по глобальным методам, свойствам и типам данных платформы через 5 специализированных инструментов.
+MCP (Model Context Protocol) сервер предназначен исключительно для интеграции с AI-ассистентами. Он предоставляет стандартизированный доступ к справочной информации по встроенным функциям, типам, методам и свойствам платформы 1С:Предприятие (аналогично "Синтаксис-помощнику"). Сервер поддерживает поиск и получение справки по объектной модели и синтаксису платформы через 5 специализированных инструментов.
 
 ## Возможности
 
 ### Tool: search
-- **Назначение** - поиск по API платформы 1С Предприятие
+- **Назначение** — поиск по справке платформы 1С:Предприятие (встроенные функции, методы, свойства, типы данных)
 - **Параметры**:
-  - `query` (обязательный) - поисковый запрос
-  - `type` (опциональный) - тип элемента (`method`, `property`, `type`)
-  - `limit` (опциональный) - максимальное количество результатов (1-50, по умолчанию 10)
+  - `query` (обязательный) — поисковый запрос
+  - `type` (опциональный) — тип элемента (`method`, `property`, `type`)
+  - `limit` (опциональный) — максимальное количество результатов (1-50, по умолчанию 10)
 
 ### Tool: info  
-- **Назначение** - получение детальной информации об элементе API
+- **Назначение** — получение детальной справки об элементе платформы 1С (функция, метод, свойство, тип)
 - **Параметры**:
-  - `name` (обязательный) - имя элемента API
-  - `type` (опциональный) - тип элемента (`method`, `property`, `type`)
+  - `name` (обязательный) — имя элемента
+  - `type` (опциональный) — тип элемента (`method`, `property`, `type`)
 
 ### Tool: getMember
-- **Назначение** - получение информации о методе или свойстве конкретного типа
+- **Назначение** — получение информации о методе или свойстве конкретного типа платформы 1С
 - **Параметры**:
-  - `typeName` (обязательный) - имя типа 1С (например, "СправочникСсылка", "ДокументОбъект")
-  - `memberName` (обязательный) - имя метода или свойства типа
+  - `typeName` (обязательный) — имя типа 1С (например, "СправочникСсылка", "ДокументОбъект")
+  - `memberName` (обязательный) — имя метода или свойства типа
 
 ### Tool: getMembers
-- **Назначение** - получение полного списка всех методов и свойств для указанного типа
+- **Назначение** — получение полного списка всех методов и свойств для указанного типа платформы 1С
 - **Параметры**:
-  - `typeName` (обязательный) - имя типа 1С для получения его элементов
+  - `typeName` (обязательный) — имя типа 1С для получения его элементов
 
 ### Tool: getConstructors
-- **Назначение** - получение списка конструкторов для указанного типа
+- **Назначение** — получение списка способов создания объектов (конструкторов) для указанного типа платформы 1С
 - **Параметры**:
-  - `typeName` (обязательный) - имя типа данных 1С (например, "Массив", "Структура", "ТаблицаЗначений")
+  - `typeName` (обязательный) — имя типа данных 1С (например, "Массив", "Структура", "ТаблицаЗначений")
 
 ## Алгоритм поиска
 
@@ -63,8 +63,23 @@ MCP (Model Context Protocol) сервер предоставляет станд
 java -jar build/libs/mcp-bsl-context.jar --platform-path /path/to/1c/platform
 ```
 
+#### Использование переменных окружения
+
+Вместо передачи параметра `--platform-path` можно задать переменную окружения:
+- `PLATFORM_CONTEXT_PATH` — путь к каталогу установки 1С Предприятия (аналогично `--platform-path`)
+
+Для управления логированием можно задать переменную окружения:
+- `LOG_FILE` — путь к файлу для логов сервера (по умолчанию `mcp-server.log` в рабочей директории)
+
+Пример запуска с переменными окружения:
+
+```bash
+PLATFORM_CONTEXT_PATH="/opt/1cv8/x86_64/8.3.25.1257" LOG_FILE="/tmp/mcp-server.log" \
+  java -jar build/libs/mcp-bsl-context.jar
+```
+
 ### Параметры запуска
-- `--platform-path` (обязательный) - путь к каталогу установки 1С Предприятия
+- `--platform-path` - путь к каталогу установки 1С Предприятия
 - `--verbose` - включить отладочное логирование
 - `--help` - показать справку
 

gradle/libs.versions.toml

@@ -1,5 +1,6 @@
 [versions]
 kotlin = "2.1.20"
+kotlin-logging = "7.0.3"
 springBoot = "3.5.0"
 springDependencyManagement = "1.1.7"
 gitVersioning = "6.4.4"
@@ -13,6 +14,7 @@ antlr = "4.9.3"
 junit-bom = "5.11.4"
 assertj = "3.8.0"
 slf4j-log4j12 = "1.7.30"
+kotlinx-cli = "0.3.6"
 
 springAi = "1.0.0"
 ktlint = "1.4.1"
@@ -23,6 +25,7 @@ jacoco = "0.8.11"
 kotlin-reflect = { group = "org.jetbrains.kotlin", name = "kotlin-reflect" }
 kotlin-stdlib-jdk8 = { group = "org.jetbrains.kotlin", name = "kotlin-stdlib-jdk8" }
 kotlin-test-junit5 = { group = "org.jetbrains.kotlin", name = "kotlin-test-junit5" }
+kotlin-logging-jvm = { group = "io.github.oshai", name = "kotlin-logging-jvm", version.ref = "kotlin-logging" }
 
 # Spring Boot
 spring-boot-starter = { group = "org.springframework.boot", name = "spring-boot-starter" }
@@ -47,6 +50,9 @@ janino = { group = "org.codehaus.janino", name = "janino", version.ref = "janino
 # Reactor
 reactor-core = { group = "io.projectreactor", name = "reactor-core", version.ref = "reactor-core" }
 
+# Kotlinx CLI
+kotlinx-cli = { group = "org.jetbrains.kotlinx", name = "kotlinx-cli", version.ref = "kotlinx-cli" }
+
 # ANTLR
 antlr4-runtime = { group = "org.antlr", name = "antlr4-runtime", version.ref = "antlr" }
 antlr4 = { group = "org.antlr", name = "antlr4", version.ref = "antlr" }
@@ -62,7 +68,9 @@ assertj-core = { group = "org.assertj", name = "assertj-core", version.ref = "as
 # Kotlin bundle
 kotlin = [
     "kotlin-reflect",
-    "kotlin-stdlib-jdk8"
+    "kotlin-stdlib-jdk8",
+    "kotlin-logging-jvm",
+    "kotlinx-cli"
 ]
 
 # Jackson bundle