Skip to content
Back to search

mcp-bsl-platform-context

MCP сервер для AI-ассистентов (справка по синтаксису и объектной модели 1С:Предприятие)

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/alkoleft--mcp-bsl-platform-context/badge.svg)](/listings/alkoleft--mcp-bsl-platform-context)

HTML

<a href="/listings/alkoleft--mcp-bsl-platform-context"><img src="/api/listings/alkoleft--mcp-bsl-platform-context/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 277 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # MCP сервер для AI-ассистентов (справка по синтаксису и объектной модели 1С:Предприятие)
  2. **MCP (Model Context Protocol) сервер** — это инструмент для интеграции с AI-ассистентами (например, Claude Desktop, Cursor IDE), предоставляющий быстрый и стандартизированный доступ к справочной информации по встроенным функциям, типам данных, методам и свойствам платформы 1С:Предприятие. MCP сервер позволяет AI-ассистентам работать с "Синтаксис-помощником" 1С в интерактивном режиме.
  3. ## Обзор
  4. Приложение `mcp-bsl-context` предназначено исключительно для интеграции с AI-ассистентами, чтобы они могли выполнять поиск по справке платформы 1С:Предприятие и получать детальную информацию о встроенных функциях, типах, методах и свойствах (аналогично работе с "Синтаксис-помощником" или официальной документацией 1С).
  5. ### 🤖 Возможности MCP сервера
  6. - **Поиск по справке платформы 1С** — нечеткий поиск по встроенным функциям, методам, свойствам и типам данных
  7. - **Детальная справка** — получение подробной информации о функциях, методах, свойствах и типах, включая сигнатуры и описания
  8. - **Навигация по объектной модели** — просмотр методов и свойств конкретных типов данных
  9. - **Информация о конструкторах** — способы создания объектов платформы 1С
  10. - **Интеграция с AI** — стандартизированный протокол MCP для взаимодействия с AI-ассистентами
  11. - **Два режима работы** — STDIO для локальной разработки и SSE для сетевого доступа
  12. Проект использует Spring Boot и Spring AI для создания MCP сервера на базе Kotlin.
  13. ## Режимы работы
  14. ### STDIO режим (по умолчанию)
  15. - **Назначение** — локальная интеграция с MCP клиентами
  16. - **Транспорт** — стандартный ввод/вывод (stdin/stdout)
  17. - **Применение** — Claude Desktop, Cursor IDE, VS Code
  18. - **Преимущества** — простота настройки, низкие накладные расходы
  19. ### SSE режим (Server-Sent Events)
  20. - **Назначение** — сетевая интеграция и веб-интерфейс
  21. - **Транспорт** — HTTP с Server-Sent Events
  22. - **Применение** — веб-клиенты, удаленные подключения, REST API
  23. - **Преимущества** — сетевой доступ, встроенный веб-интерфейс, real-time коммуникация
  24. ## Требования
  25. ### Системные требования
  26. - **Java**: версия 17 или выше
  27. - **Операционная система**: Linux, macOS, Windows
  28. - **Память**: минимум 512 МБ RAM для работы приложения
  29. - **Место на диске**: 100 МБ для установки приложения
  30. ### Для MCP сервера
  31. - **Платформа 1С Предприятие**: версия 8.3.20 или выше (рекомендуется)
  32. - **MCP клиент**: Claude Desktop, Cursor IDE или другой совместимый MCP клиент
  33. - **Сетевое подключение**: для загрузки зависимостей при первом запуске
  34. ### Зависимости времени выполнения
  35. Все необходимые зависимости включены в исполняемый JAR-файл:
  36. - Spring Boot 3.5.0
  37. - Spring AI 1.0.0
  38. - Jackson 2.15.2
  39. - Kotlin Coroutines
  40. ## Сборка
  41. Проект собирается с помощью Gradle. Для сборки выполните следующую команду в корневой директории проекта:
  42. ```bash
  43. ./gradlew build
  44. ```
  45. После успешной сборки исполняемый JAR-файл будет находиться в директории `build/libs/`.
  46. ## Использование
  47. ### Запуск MCP сервера
  48. Linux
  49. ```bash
  50. java -jar mcp-bsl-context-<версия>.jar [опции]
  51. ```
  52. Windows
  53. ```bash
  54. java -Dfile.encoding=UTF-8 -jar mcp-bsl-context-<версия>.jar [опции]
  55. ```
  56. **Опции:**
  57. - `--platform-path`, `-p` - путь к каталогу установки 1С Предприятия
  58. - `--help`, `-h` - показать справку по использованию
  59. - `--verbose` - включить отладочное логирование
  60. - `--mode`, `-m` - режим работы: sse (HTTP Server-Sent Events) или stdio (стандартный ввод/вывод) (по умолчанию stdio)
  61. - `--port` - порт для SSE сервера (по умолчанию 8080)
  62. **Примеры:**
  63. ```bash
  64. # STDIO режим (по умолчанию)
  65. java -jar mcp-bsl-context-0.3.0.jar --platform-path "/opt/1cv8/x86_64/8.3.25.1257"
  66. # SSE режим (HTTP Server-Sent Events)
  67. java -jar mcp-bsl-context-0.3.0.jar --mode sse --platform-path "/opt/1cv8/x86_64/8.3.25.1257"
  68. # SSE режим с кастомным портом
  69. java -jar mcp-bsl-context-0.3.0.jar --mode sse --port 9000 --platform-path "/opt/1cv8/x86_64/8.3.25.1257"
  70. # Сокращенная форма
  71. java -jar mcp-bsl-context-0.3.0.jar -m stdio -p "/opt/1cv8/x86_64/8.3.25.1257"
  72. # Показать справку
  73. java -jar mcp-bsl-context-0.3.0.jar --help
  74. ```
  75. **Примеры запуска в Windows:**
  76. ```cmd
  77. # STDIO режим (по умолчанию)
  78. java -Dfile.encoding=UTF-8 -jar mcp-bsl-context-0.3.0.jar --platform-path "C:\Program Files\1cv8\8.3.27.1606"
  79. ```
  80. ### Возможности MCP сервера
  81. #### Инструменты (Tools) доступные через MCP:
  82. - **search** - поиск по API платформы 1С Предприятие
  83. - **info** - получение детальной информации об элементе API
  84. - **getMember** - получение информации о методе или свойстве конкретного типа
  85. - **getMembers** - получение полного списка всех методов и свойств для указанного типа
  86. - **getConstructors** - получение списка конструкторов для указанного типа
  87. Подробная документация по использованию MCP сервера доступна в [MCP_SERVER_USAGE.md](documentation/README.md).
  88. ## Интеграция с AI клиентами
  89. ### STDIO режим (по умолчанию)
  90. Для локального использования с AI клиентами через stdin/stdout.
  91. **Claude Desktop** - добавьте конфигурацию в `claude_desktop_config.json`:
  92. ```json
  93. {
  94. "mcpServers": {
  95. "1c-platform": {
  96. "command": "java",
  97. "args": [
  98. "-jar",
  99. "/path/to/mcp-bsl-context.jar",
  100. "--platform-path",
  101. "/opt/1cv8/x86_64/8.3.25.1257"
  102. ]
  103. }
  104. }
  105. }
  106. ```
  107. Пример настройки для работы в Windows
  108. ```json
  109. "mcpServers": {
  110. "1c-platform": {
  111. "type": "stdio",
  112. "command": "java",
  113. "args": [
  114. "-Dfile.encoding=UTF-8",
  115. "-jar",
  116. "C:\\your_path\\mcp-bsl-context-0.3.0.jar",
  117. "--platform-path",
  118. "C:\\Program Files\\1cv8\\8.3.27.1606"
  119. ],
  120. "env": {
  121. "LOG_FILE": "C:\\cmd\\mcp-server.log"
  122. }
  123. }
  124. }
  125. ```
  126. **Cursor IDE** - создайте файл `.cursor/mcp.json` в корне проекта:
  127. ```json
  128. {
  129. "mcpServers": {
  130. "1c-platform": {
  131. "command": "java",
  132. "args": [
  133. "-jar",
  134. "/path/to/mcp-bsl-context.jar",
  135. "--platform-path",
  136. "/opt/1cv8/x86_64/8.3.25.1257"
  137. ]
  138. }
  139. }
  140. }
  141. ```
  142. Пример настройки для работы в Windows
  143. ```json
  144. "mcpServers": {
  145. "1c-platform": {
  146. "type": "stdio",
  147. "command": "java",
  148. "args": [
  149. "-Dfile.encoding=UTF-8",
  150. "-jar",
  151. "C:\\your_path\\mcp-bsl-context-0.3.0.jar",
  152. "--platform-path",
  153. "C:\\Program Files\\1cv8\\8.3.27.1606"
  154. ],
  155. "env": {
  156. "LOG_FILE": "C:\\cmd\\mcp-server.log"
  157. }
  158. }
  159. }
  160. ```
  161. ### SSE режим (HTTP Server-Sent Events)
  162. Для сетевого доступа и веб-интерфейса.
  163. **Запуск сервера:**
  164. ```bash
  165. java -jar mcp-bsl-context.jar --mode sse --platform-path "/opt/1cv8/x86_64/8.3.25.1257"
  166. ```
  167. **Доступные эндпоинты:**
  168. - `http://localhost:8080/sse` - SSE соединение
  169. **Подключение через URL:**
  170. ```json
  171. {
  172. "mcpServers": {
  173. "1c-platform-sse": {
  174. "url": "http://localhost:8080/mcp/sse"
  175. }
  176. }
  177. }
  178. ```
  179. **Пример HTTP запроса:**
  180. ```bash
  181. curl -X POST http://localhost:8080/mcp/request \
  182. -H "Content-Type: application/json" \
  183. -d '{
  184. "id": "req-1",
  185. "method": "search",
  186. "params": {
  187. "query": "СтрНайти",
  188. "type": "method",
  189. "limit": 5
  190. }
  191. }'
  192. ```
  193. ## Документация
  194. - [Обзор](documentation/00_OVERVIEW.md) - общий обзор и быстрый старт
  195. - [Возможности](documentation/01_CAPABILITIES.md) - описание доступных инструментов и функций
  196. - [Установка и запуск](documentation/02_SETUP.md) - инструкции по установке и настройке
  197. - [Docker](documentation/03_DOCKER.md) - работа с Docker контейнерами
  198. - [Техническая документация](documentation/04_TECHNICAL.md) - архитектура и технические детали
  199. - [Интеграция](documentation/05_INTEGRATION.md) - интеграция с IDE и AI клиентами
  200. - [SSE режим](documentation/SSE_USAGE.md) - подробная документация по SSE режиму
  201. - [Использование MCP сервера](documentation/README.md) - базовое использование
  202. ## Алгоритм поиска
  203. Поиск выполняется по принципу нечеткого соответствия с ранжированием:
  204. 1. **Точное совпадение** (100 баллов) - имя полностью совпадает с запросом
  205. 2. **Префиксное совпадение** (80 баллов) - имя начинается с запроса
  206. 3. **Частичное совпадение** (60 баллов) - имя содержит запрос
  207. 4. **Совпадение в сигнатуре** (40 баллов) - запрос найден в сигнатуре
  208. 5. **Совпадение в описании** (20 баллов) - запрос найден в описании
  209. 6. **Fuzzy matching** (0-50 баллов) - на основе расстояния Левенштейна
  210. ## Зависимости
  211. Основные зависимости проекта:
  212. - Spring Boot 3.5.0
  213. - Spring AI MCP Server
  214. - Kotlin с Coroutines
  215. - Jackson (для работы с JSON)
  216. - Logback для логирования
  217. ## Использованные идеи
  218. Алгоритм чтения справки базируется на идеях [bsl-context](https://github.com/1c-syntax/bsl-context) (от [1c-syntax](https://github.com/1c-syntax/)).
  219. ## Лицензия
  220. Этот проект распространяется под лицензией MIT. Подробную информацию смотрите в файле [LICENSE](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.