SkillFoxx

1C Syntax Checker MCP

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

  • 1 ★ on the repository
  • Last commit
  • MIT
MCP server

Extended access

Why this level

  • Downloads BSL Language Server and runs it in Docker on port 8010
  • Analyzes submitted code and files and writes nothing to the project
All reasons and checks
Russian stack

yavityai/1c_syntaxcheckerAuthor:yavityai

Install

Manual install

./scripts/install.sh && ./scripts/start.sh

Downloads the BSL Language Server JAR and builds the Docker image, then starts the server on port 8010.

Access and checks

How we review

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

  • Downloads BSL Language Server and runs it in Docker on port 8010
  • Analyzes submitted code and files and writes nothing to the project

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

What it does

The server runs BSL Language Server 0.29.0 on Temurin 21 inside a Docker image and gives the agent three tools: syntaxcheck for a standalone code snippet, syntaxcheck_file for a single file with a path so naming rules apply correctly by module type, and syntaxcheck_project for several files at once with cross-module diagnostics. The min_severity parameter filters from HINT to ERROR, and the response includes per-level counters, a diagnostics list with the file, and a human-readable summary_text. Java is not needed on the agent's machine: all analysis runs inside the container.

Who it is for. For 1C developers in Cursor who need a quick BSL syntax check without installing Java or leaving the editor.

Good fit when

  • You need to check agent-generated BSL code for errors before inserting it
  • You need cross-module diagnostics across several files at once
  • You do not want to install Java and BSL Language Server locally

Not a fit when

  • Docker Desktop or Docker Engine is not available on the machine
  • You need code navigation and refactoring, not just a syntax check

Example request

Check this module for WARNING-level issues and above, and show only the warnings

MCP

Transport
http
Authentication
not required

Environment variables

SYNTAXCHECK_PORT
Host port, defaults to 8010.
BSL_VERSION
BSL Language Server version, defaults to 0.29.0.

Limitations

Needs Docker and about 2 GB for the image and the BSL Language Server JAR. The server version is pinned to bsl.version; updating requires rebuilding the image. A weekly GitHub Actions job only opens an issue about a new BSL LS release, there is no auto-update.

How to disable. Stop the container with stop.sh or stop.ps1 and remove the server from .cursor/mcp.json.

FAQ

Is Java needed on my machine?

No, Temurin 21 and BSL Language Server run only inside the Docker container.

How do you update the BSL Language Server version?

With python -m syntaxcheck_mcp.cli update-bsl, which syncs bsl.version and .env, then the image needs rebuilding.

Discussion

No questions or reviews yet.

All 1C:Enterprise tools
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 access1
Russian stack

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

MCP serverExtended access6
Russian stack

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

MCP serverExtended access71
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 access1
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 access117
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

README in short

The README describes three MCP tools with a table of parameters and severity levels, install via install.ps1 or install.sh, a Python CLI with install, start, stop, set-port, mcp-snippet, test and update-bsl commands, port changes, and a weekly workflow that opens an issue when a new BSL Language Server version ships.

README badge

Report a problem