MCP wrapper for BSL Language Server

BSL MCP Server

A small MCP server that runs BSL Language Server as a JAR file and gives an agent BSL code analysis and formatting as JSON

  • 6 ★ on the repository
  • Last commit
MCP server

Extended access

Why this level

  • bsl_format rewrites BSL files in the given directory
  • Runs an external Java JAR process with a configurable memory limit
All reasons and checks
Russian stack

phsin/mcp-bsl-ls

Install

Manual install

pip install -r requirements.txt
pip install -e .

Install from source after cloning the repository.

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • bsl_format rewrites BSL files in the given directory
  • Runs an external Java JAR process with a configurable memory limit

This is third-party code. Review the repository files before installing.

What it does

The server wraps the ready-made BSL Language Server JAR with two tools: bsl_analyze runs analysis on a .bsl/.os directory or file and returns a human-readable summary plus a structured JSON with diagnostics, paths, lines and severity levels, and bsl_format applies BSL Language Server's formatting rules to files. The server doesn't perform 1C platform syntax or function checks itself; that's BSL Language Server's own job. Timeouts are fixed at 5 minutes for analysis and 2 minutes for formatting, and JVM memory is tunable via an environment variable.

Who it is for. For 1C developers in Cursor who already have BSL Language Server set up and want a minimal MCP bridge to it without any custom analysis logic.

Good fit when

  • You want an agent to get BSL Language Server diagnostics right from the chat
  • You need to format a batch of BSL files by BSL Language Server's rules
  • You already have a configured .bsl-language-server.json and JAR file and just need an MCP interface to them

Not a fit when

  • You need 1C platform syntax checking: the README explicitly says the server doesn't do that
  • Java 8 or newer, or the BSL Language Server JAR, isn't set up
  • You need relative paths: the README requires absolute paths only

Example request

Check the C:\1C\lk\src\CommonModules directory for BSL Language Server diagnostics and show the top issues

MCP

Transport
stdio
Authentication
not required

Environment variables

BSL_JAR required
Path to the BSL Language Server JAR file.
BSL_CONFIG
Path to the .bsl-language-server.json settings file.
BSL_MEMORY_MB
JVM memory limit for analysis, in megabytes.

Limitations

The server does not perform 1C platform syntax or function checks, only what BSL Language Server itself does. A separately downloaded BSL Language Server JAR and Java Runtime 8 or newer are required. Operation depends on absolute paths; relative ones may not work correctly. Analysis and formatting timeouts are not user-configurable.

How to disable. Remove the bsl-mcp block from ~/.cursor/mcp.json or uninstall the package with pip uninstall.

FAQ

Does the server check 1C platform syntax itself?

No, the README explicitly says it does not perform platform syntax or function checks, only BSL Language Server's own diagnostics.

Why do absolute paths matter?

The README separately warns that relative paths may not work correctly with the server and recommends always using an absolute path.

Discussion

No questions or reviews yet.

Russian stack

An MCP server for 1C static analysis and formatting on BSL Language Server 0.29, adapted for that version's changed CLI syntax

MCP serverExtended access1Repository stars
Russian stack

A script installs BSL Language Server as a Linux systemd service and, with a flag, opens an MCP endpoint for AI agents

MCP serverExtended access
Russian stack

A Dockerized MCP server that keeps BSL Language Server running and gives the agent code navigation, diagnostics and refactoring for 1C instead of grep search

MCP serverExtended access1Repository stars
Russian stack

MCP bridge to BSL Language Server: navigation, diagnostics and refactoring of 1C and OneScript code for agents

MCP serverExtended access71Repository stars
Russian stack

An MCP server for BSL syntax checks on BSL Language Server in Docker: send code, get back JSON errors and warnings with no Java install needed

MCP serverExtended access1Repository stars
Russian stack

A Rust-based Language Server for BSL with code diagnostics, incremental analysis and a built-in MCP server for AI agents

MCP serverExtended access117Repository stars

Alternatives

Tools by other authors for the same tasks.

README in short

The README describes two tools, bsl_analyze and bsl_format, the Python, Java and BSL Language Server JAR requirements, an example Cursor MCP config with BSL_JAR, BSL_MEMORY_MB, BSL_CONFIG and BSL_LOG_LEVEL variables, an example .bsl-language-server.json, handling of common errors, the project structure, and a detailed troubleshooting section covering already-fixed issues like duplicate logs. MIT license.

README badge

Report a problem