MCP BSL Language Server
An MCP server for 1C static analysis and formatting on BSL Language Server 0.29, adapted for that version's changed CLI syntax
Medium risk
We rate an entry medium when the tool runs code, makes network calls or reads project files. Check what exactly it does before installing.
Why this level
- bsl_format rewrites code files on disk according to style rules
Install
Manual install
install.batCreates an isolated venv and installs dependencies.
This is third-party code. Review the repository files before installing.
What it does
The server runs a local BSL Language Server 0.29.0 JAR and gives the agent two tools: bsl_analyze for static analysis of .bsl and .os files with errors, warnings and hints, and bsl_format for formatting by configured style rules. Both tools accept a file or directory path. The project accounts for the fact that version 0.29.0 changed BSL Language Server's CLI syntax: the analyze and format subcommands dropped the -- prefix, and some parameters were renamed.
Who it is for. For 1C developers on Windows who need BSL static analysis and formatting right from Cursor without building their own bridge.
Good fit when
- You need a quick error check of .bsl files before a commit
- You need consistent formatting by BSL Language Server rules
- You already run BSL Language Server specifically at version 0.29.0
Not a fit when
- You need a different BSL Language Server version: 0.29.0's CLI syntax differs from older releases
- You are not on Windows: the instructions and install.bat target it
Example request
Check this BSL module for errors and format it by the standard rulesLimitations
Server and JAR paths are hardcoded in the config and need manual editing for your machine, including src/mcp_bsl/config.py when the project is moved. Requires a separately installed JDK 17+ and the BSL Language Server 0.29.0 JAR itself. Small project, single author, documentation limited to the README.
How to disable. Remove the bsl-mcp entry from your Cursor MCP client configuration.
MCP
- Transport
- stdio
- Authentication
- not required
| Environment variables | |
|---|---|
| BSL_JAR required | Path to the BSL Language Server JAR file. |
| BSL_MEMORY_MB | JVM heap size in megabytes, defaults to 4096. |
| BSL_CONFIG | Path to .bsl-language-server.json. |
Security check
- bsl_format rewrites code files on disk according to style rules
README in short
The README lists prerequisites (JDK 17+, Python 3.10+, the BSL Language Server 0.29.0 JAR), two install paths via install.bat or pip, a Cursor config example with the BSL_JAR, BSL_MEMORY_MB, BSL_CONFIG and BSL_LOG_LEVEL environment variables, a two-tool table, and a compatibility section on the version 0.29.0 CLI changes.
FAQ
How does this differ from phsin/mcp-bsl-ls?
It adapts the original project to the CLI syntax that BSL Language Server changed in version 0.29.0.
Does Java need to be on the machine running the MCP client?
Yes, JDK 17+ is needed to run the BSL Language Server JAR that the server invokes.
Related
A skills library that gives coding agents a development process: brainstorming, planning, TDD, subagents and code review
Skills for real engineers by Matt Pocock
Skills For Real Engineers
Small composable skills for engineering with agents: plan grilling, TDD, bug diagnosis, code review and architecture
GitHub toolkit for spec-driven development: the specify CLI adds agent commands and skills to a project, from principles to implementation
Reference MCP servers
Model Context Protocol servers
Official reference MCP servers: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time and Everything