by alkoleft
MCP сервер для AI-ассистентов (справка по синтаксису и объектной модели 1С:Предприятие)
# Add to your Claude Code skills
git clone https://github.com/alkoleft/mcp-bsl-platform-contextMCP (Model Context Protocol) сервер — это инструмент для интеграции с AI-ассистентами (например, Claude Desktop, Cursor IDE), предоставляющий быстрый и стандартизированный доступ к справочной информации по встроенным функциям, типам данных, методам и свойствам платформы 1С:Предприятие. MCP сервер позволяет AI-ассистентам работать с "Синтаксис-помощником" 1С в интерактивном режиме.
Приложение mcp-bsl-context предназначено исключительно для интеграции с AI-ассистентами, чтобы они могли выполнять поиск по справке платформы 1С:Предприятие и получать детальную информацию о встроенных функциях, типах, методах и свойствах (аналогично работе с "Синтаксис-помощником" или официальной документацией 1С).
Проект использует Spring Boot и Spring AI для создания MCP сервера на базе Kotlin.
No comments yet. Be the first to share your thoughts!
Все необходимые зависимости включены в исполняемый JAR-файл:
Проект собирается с помощью Gradle. Для сборки выполните следующую команду в корневой директории проекта:
./gradlew build
После успешной сборки исполняемый JAR-файл будет находиться в директории build/libs/.
Linux
java -jar mcp-bsl-context-<версия>.jar [опции]
Windows
java -Dfile.encoding=UTF-8 -jar mcp-bsl-context-<версия>.jar [опции]
Опции:
--platform-path, -p - путь к каталогу установки 1С Предприятия--help, -h - показать справку по использованию--verbose - включить отладочное логирование--mode, -m - режим работы: sse (HTTP Server-Sent Events) или stdio (стандартный ввод/вывод) (по умолчанию stdio)--port - порт для SSE сервера (по умолчанию 8080)Примеры:
# STDIO режим (по умолчанию)
java -jar mcp-bsl-context-0.3.0.jar --platform-path "/opt/1cv8/x86_64/8.3.25.1257"
# SSE режим (HTTP Server-Sent Events)
java -jar mcp-bsl-context-0.3.0.jar --mode sse --platform-path "/opt/1cv8/x86_64/8.3.25.1257"
# SSE режим с кастомным портом
java -jar mcp-bsl-context-0.3.0.jar --mode sse --port 9000 --platform-path "/opt/1cv8/x86_64/8.3.25.1257"
# Сокращенная форма
java -jar mcp-bsl-context-0.3.0.jar -m stdio -p "/opt/1cv8/x86_64/8.3.25.1257"
# Показать справку
java -jar mcp-bsl-context-0.3.0.jar --help
Примеры запуска в Windows:
# STDIO режим (по умолчанию)
java -Dfile.encoding=UTF-8 -jar mcp-bsl-context-0.3.0.jar --platform-path "C:\Program Files\1cv8\8.3.27.1606"
Подробная документация по использованию MCP сервера доступна в MCP_SERVER_USAGE.md.
Для локального использования с AI клиентами через stdin/stdout.
Claude Desktop - добавьте конфигурацию в claude_desktop_config.json:
{
"mcpServers": {
"1c-platform": {
"command": "java",
"args": [
"-jar",
"/path/to/mcp-bsl-context.jar",
"--platform-path",
"/opt/1cv8/x86_64/8.3.25.1257"
]
}
}
}
Пример настройки для работы в Windows
"mcpServers": {
"1c-platform": {
"type": "stdio",
"command": "java",
"args": [
"-Dfile.encoding=UTF-8",
"-jar",
"C:\\your_path\\mcp-bsl-context-0.3.0.jar",
"--platform-path",
"C:\\Program Files\\1cv8\\8.3.27.1606"
],
"env": {
"LOG_FILE": "C:\\cmd\\mcp-server.log"
}
}
}
Cursor IDE - создайте файл .cursor/mcp.json в корне проекта:
{
"mcpServers": {
"1c-platform": {
"command": "java",
"args": [
"-jar",
"/path/to/mcp-bsl-context.jar",
"--platform-path",
"/opt/1cv8/x86_64/8.3.25.1257"
]
}
}
}
Пример настройки для работы в Windows
"mcpServers": {
"1c-platform": {
"type": "stdio",
"command": "java",
"args": [
"-Dfile.encoding=UTF-8",
"-jar",
"C:\\your_path\\mcp-bsl-context-0.3.0.jar",
"--platform-path",
"C:\\Program Files\\1cv8\\8.3.27.1606"
],
"env": {
"LOG_FILE": "C:\\cmd\\mcp-server.log"
}
}
}
Для сетевого доступа и веб-интерфейса.
Запуск сервера:
java -jar mcp-bsl-context.jar --mode sse --platform-path "/opt/1cv8/x86_64/8.3.25.1257"
Доступные эндпоинты:
http://localhost:8080/sse - SSE соединениеПодключение через URL:
{
"mcpServers": {
"1c-platform-sse": {
"url": "http://localhost:8080/mcp/sse"
}
}
}
Пример HTTP запроса:
curl -X POST http://localhost:8080/mcp/request \
-H "Content-Type: application/json" \
-d '{
"id": "req-1",
"method": "search",
"params": {
"query": "СтрНайти",
"type": "method",
"limit": 5
}
}'
Поиск выполняется по принципу нечеткого соответствия с ранжированием:
Основные зависимости проекта:
Алгоритм чтения справки базируется на идеях bsl-context (от 1c-syntax).
Этот проект распространяется под лицензией MIT. Подробную информацию смотрите в файле LICENSE.