mcp-bsl-platform-context

作者 alkoleft已验证

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

188
Stars
28
Forks
Kotlin
语言
2026/8/23
添加时间

⚠️ 第三方软件声明

本 Skill 为第三方开源软件,独立托管于 GitHub。SkillTip 仅为信息目录,不控制或维护底层仓库。所显示的安全检查为自动化且范围有限,安装前请自行审查源码。

阅读服务条款

安装

添加到你的 Claude Code skills 目录:

# Add to your Claude Code skills
git clone https://github.com/alkoleft/mcp-bsl-platform-context

快速入门

使用 mcp-bsl-platform-context 等 Skills 的指南。

安全报告

已验证

上次扫描:—

{
  "status": "PASSED",
  "issues": []
}

README.md

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

MCP (Model Context Protocol) сервер — это инструмент для интеграции с AI-ассистентами (например, Claude Desktop, Cursor IDE), предоставляющий быстрый и стандартизированный доступ к справочной информации по встроенным функциям, типам данных, методам и свойствам платформы 1С:Предприятие. MCP сервер позволяет AI-ассистентам работать с "Синтаксис-помощником" 1С в интерактивном режиме.

Обзор

Приложение mcp-bsl-context предназначено исключительно для интеграции с AI-ассистентами, чтобы они могли выполнять поиск по справке платформы 1С:Предприятие и получать детальную информацию о встроенных функциях, типах, методах и свойствах (аналогично работе с "Синтаксис-помощником" или официальной документацией 1С).

🤖 Возможности MCP сервера

  • Поиск по справке платформы 1С — нечеткий поиск по встроенным функциям, методам, свойствам и типам данных
  • Детальная справка — получение подробной информации о функциях, методах, свойствах и типах, включая сигнатуры и описания
  • Навигация по объектной модели — просмотр методов и свойств конкретных типов данных
  • Информация о конструкторах — способы создания объектов платформы 1С
  • Интеграция с AI — стандартизированный протокол MCP для взаимодействия с AI-ассистентами
  • Два режима работы — STDIO для локальной разработки и SSE для сетевого доступа

Проект использует Spring Boot и Spring AI для создания MCP сервера на базе Kotlin.

Режимы работы

STDIO режим (по умолчанию)

  • Назначение — локальная интеграция с MCP клиентами
  • Транспорт — стандартный ввод/вывод (stdin/stdout)
  • Применение — Claude Desktop, Cursor IDE, VS Code
  • Преимущества — простота настройки, низкие накладные расходы

SSE режим (Server-Sent Events)

  • Назначение — сетевая интеграция и веб-интерфейс
  • Транспорт — HTTP с Server-Sent Events
  • Применение — веб-клиенты, удаленные подключения, REST API
  • Преимущества — сетевой доступ, встроенный веб-интерфейс, real-time коммуникация

Требования

Системные требования

  • Java: версия 17 или выше
  • Операционная система: Linux, macOS, Windows
  • Память: минимум 512 МБ RAM для работы приложения
  • Место на диске: 100 МБ для установки приложения

Для MCP сервера

  • Платформа 1С Предприятие: версия 8.3.20 или выше (рекомендуется)
  • MCP клиент: Claude Desktop, Cursor IDE или другой совместимый MCP клиент
  • Сетевое подключение: для загрузки зависимостей при первом запуске

Зависимости времени выполнения

Все необходимые зависимости включены в исполняемый JAR-файл:

  • Spring Boot 3.5.0
  • Spring AI 1.0.0
  • Jackson 2.15.2
  • Kotlin Coroutines

Сборка

Проект собирается с помощью Gradle. Для сборки выполните следующую команду в корневой директории проекта:

./gradlew build

После успешной сборки исполняемый JAR-файл будет находиться в директории build/libs/.

Использование

Запуск MCP сервера

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 сервера

Инструменты (Tools) доступные через MCP:

  • search - поиск по API платформы 1С Предприятие
  • info - получение детальной информации об элементе API
  • getMember - получение информации о методе или свойстве конкретного типа
  • getMembers - получение полного списка всех методов и свойств для указанного типа
  • getConstructors - получение списка конструкторов для указанного типа

Подробная документация по использованию MCP сервера доступна в MCP_SERVER_USAGE.md.

Интеграция с AI клиентами

STDIO режим (по умолчанию)

Для локального использования с 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"
      }
    }
}

SSE режим (HTTP Server-Sent Events)

Для сетевого доступа и веб-интерфейса.

Запуск сервера:

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
    }
  }'

Документация

Алгоритм поиска

Поиск выполняется по принципу нечеткого соответствия с ранжированием:

  1. Точное совпадение (100 баллов) - имя полностью совпадает с запросом
  2. Префиксное совпадение (80 баллов) - имя начинается с запроса
  3. Частичное совпадение (60 баллов) - имя содержит запрос
  4. Совпадение в сигнатуре (40 баллов) - запрос найден в сигнатуре
  5. Совпадение в описании (20 баллов) - запрос найден в описании
  6. Fuzzy matching (0-50 баллов) - на основе расстояния Левенштейна

Зависимости

Основные зависимости проекта:

  • Spring Boot 3.5.0
  • Spring AI MCP Server
  • Kotlin с Coroutines
  • Jackson (для работы с JSON)
  • Logback для логирования

Использованные идеи

Алгоритм чтения справки базируется на идеях bsl-context (от 1c-syntax).

Лицензия

Этот проект распространяется под лицензией MIT. Подробную информацию смотрите в файле LICENSE.

常见问题

What is mcp-bsl-platform-context?

mcp-bsl-platform-context is an open-source mcp servers skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by alkoleft. MCP сервер для AI-ассистентов (справка по синтаксису и объектной модели 1С:Предприятие). It has 188 GitHub stars.

Is mcp-bsl-platform-context safe to use?

Yes. mcp-bsl-platform-context passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.

How do I install mcp-bsl-platform-context?

Clone the repository with "git clone https://github.com/alkoleft/mcp-bsl-platform-context" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is mcp-bsl-platform-context written in?

mcp-bsl-platform-context is primarily written in Kotlin. It is open-source under alkoleft on GitHub, so you can review or fork the full source.

Are there alternatives to mcp-bsl-platform-context?

Yes. SkillsLLM lists many other MCP Servers skills you can browse and compare side by side. Open the MCP Servers category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh mcp-bsl-platform-context against similar tools.

评论 (0)

暂无评论,成为第一个分享想法的人!

n8n

by n8n-io

12

Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations.

201,88160,308TypeScript
MCP 服务器apisai-tools
查看详情

Scrapling

by D4Vinci

🕷️ An adaptive Web Scraping framework that handles everything from a single request to a full-scale crawl!

75,9137,581Python
MCP 服务器
查看详情

TrendRadar

by sansan0

⭐AI-driven public opinion & trend monitor with multi-platform aggregation, RSS, and smart alerts.🎯 告别信息过载,你的 AI 舆情监控助手与热点筛选工具!聚合多平台热点 + RSS 订阅,支持关键词精准筛选。AI 智能筛选新闻 + AI 翻译 + AI 分析简报直推手机,也支持接入 MCP 架构,赋能 AI 自然语言对话分析、情感洞察与趋势预测等。支持 Docker ,数据本地/云端自持。集成微信/飞书/钉钉/Telegram/邮件/ntfy/bark/slack 等渠道智能推送。

61,65224,883Python
MCP 服务器
查看详情

context7

by upstash

Context7 Platform -- Up-to-date code documentation for LLMs and AI code editors

61,0602,938TypeScript
MCP 服务器
查看详情

High-performance code intelligence MCP server. Indexes codebases into a persistent knowledge graph — average repo in milliseconds. 158 languages, sub-ms queries, 99% fewer tokens. Single static binary, zero dependencies.

39,9393,219C
MCP 服务器
查看详情

开发者还喜欢

基于喜欢此 Skill 的开发者投票和收藏

ECC

by affaan-m

10

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

242,21936,702JavaScript
AI 智能体ai-agentsanthropicclaude-code
查看详情
15

An agentic skills framework & software development methodology that works.

234,96620,863Shell
AI 智能体ai-agentsbrainstorming
查看详情

hermes-agent

by NousResearch

10

The agent that grows with you

234,43747,175Python
AI 智能体ai-agentsagent-orchestration
查看详情

n8n

by n8n-io

12

Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations.

201,88160,308TypeScript
MCP 服务器apisai-tools
查看详情

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

185,94028,768JavaScript
AI 智能体ai-agentsanthropicclaude-code
查看详情

cc-switch

by farion1231

3

A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build & Hermes Agent. Only official website: ccswitch.io

128,8688,826Rust
AI 智能体claude-codeai-tools
查看详情