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
- 1 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- bsl_format rewrites code files on disk according to style rules
Install
- Works in
- Services
Manual install
install.batCreates an isolated venv and installs dependencies.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- bsl_format rewrites code files on disk according to style rules
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 rulesMCP
- Transport
- stdio
- Authentication
- not required
Environment variables
BSL_JARrequired- 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.
Limitations
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.
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.
Discussion
No questions or reviews yet.
Related
All 1C:Enterprise toolsMCP 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
A script installs BSL Language Server as a Linux systemd service and, with a flag, opens an MCP endpoint for AI agents
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
A Rust-based Language Server for BSL with code diagnostics, incremental analysis and a built-in MCP server for AI agents
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 bridge to BSL Language Server: navigation, diagnostics and refactoring of 1C and OneScript code for agents
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| MCP BSL Language Server (this card) | no | not required | 1 | |
| BSL Language Server for Claude Code | no | 37 | 1C LSP | |
| BSL Language Server installer | no | not required | 0 | MCP for 1C agents |
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.