MCP Connector

Bridge 1C LSP to MCP for Code Analysis

Cross-platform manager and MCP bridge that runs multiple bsl-language-server instances for 1C projects, exposing syntax checks and code navigation.

Works with github

86
Spark score
out of 100
Updated 4 months ago
Version 0.1.4
Models
universal

Add to Favorites

Why it matters

Enhance your 1C development experience by integrating Language Server Protocol (LSP) capabilities with the Manager and MCP. Gain advanced code diagnostics and navigation features across multiple projects.

Outcomes

What it gets done

01

Provide diagnostics for 1C BSL code.

02

Enable code navigation features.

03

Support call hierarchy analysis.

04

Bridge 1C LSP instances with MCP or CLI.

Install

Add it to your toolbox

Run in your project directory:

curl -fsSL https://spark.entire.vc/get/1c-lsp-mcp-skill | bash

Overview

1C LSP MCP Skill

Runs and bridges multiple bsl-language-server instances, one per 1C project, over both MCP and SKILLs. Provides syntax diagnostics and code navigation - symbols, references, definitions, and call hierarchy - to LLM agents working on 1C codebases. Use it when an agent needs to check 1C code syntax or navigate a 1C codebase (find symbols, definitions, references, or callers/callees) instead of guessing. Requires only a JVM to run bsl-language-server, no Docker.

What it does

1C LSP MCP Skill is a cross-platform launch manager and MCP bridge that runs one or more instances of bsl-language-server - a real language server for the 1C:Enterprise BSL language - each scoped to a different 1C project. It exposes that language server's understanding of the codebase to LLM agents through both MCP and Claude-style SKILLs, so an agent gets accurate syntax diagnostics and code navigation instead of pattern-matching against training data. The project has two parts: lsp-skill-server, a console HTTP server with a web UI for managing projects and instances, and lsp-skill, a CLI for querying an already-configured project.

When to use - and when NOT to

Use it when an agent is working in a 1C codebase and needs ground-truth answers: is this code syntactically valid, where is a given procedure defined, what calls it, and what does it call. It's the right tool specifically for BSL/1C projects - it wraps bsl-language-server, so it has no relevance outside that ecosystem. It is not a code editor or a deployment tool; it only manages language-server instances and exposes their analysis, with a documented near-term goal of trimming the verbosity of bsl-language-server's raw responses.

Capabilities

Each bsl-language-server instance runs independently per 1C project, with visible indexing progress, and can be tuned individually with its own JVM flags (useful for allocating more RAM to large 1C projects) and its own language-server configuration file (for example, different diagnostic exclusions per project). Core operations available through MCP or the SKILLs CLI include: diagnostics for syntax checking; codebase navigation via symbols, references, definition, workspace-symbols, incoming-calls, and outgoing-calls; and call hierarchy queries that answer "who calls this procedure?" and "what does this procedure call?". Code changes are pushed to the running language server efficiently rather than requiring a full re-index, and the whole manager can optionally run as a background service.

How to install

Releases ship prebuilt binaries for lsp-skill-server and lsp-skill for Windows, Linux, and macOS (both arm and x64), along with two matching skill/MCP pairs: 1c-check for syntax checking and 1c-lsp for code navigation. A sample mcp.json is included for configuring MCP clients (IDEs), and sample AGENTS.md files are provided to make LLM agents more reliable about invoking the MCP or SKILLs correctly - optional, but noted to help with some models. No Docker is required; the only runtime dependency is a JVM to run bsl-language-server itself. See the project's quickstart guide for the full setup sequence.

Who it's for

Developers and teams working on 1C:Enterprise/BSL codebases who want an LLM agent to have real, language-server-backed syntax checking and code navigation - rather than guesses - across one or several 1C projects at once.

Source README

1с-lsp-mcp-skill

Cross-platform application - a launch manager and MCP bridge for multiple instances of bsl-language-server across different 1С projects.

Supports operation via both MCP and SKILLs.
No Docker or external dependencies required, only JVM to run bsl-language-server itself.

The project consists of:

  • lsp-skill-server - console HTTP server with web UI for management
  • lsp-skill - CLI for requests to an already created project

Capabilities

  • Run multiple bsl-language-server instances (one per 1С project) with indexing progress tracking (context population)
  • Syntax checking: diagnostics via MCP or SKILLs CLI
  • Push code changes from the 1С project codebase to bsl-language-server (efficient push model)
  • Code navigation: symbols, references, definition, workspace-symbols, incoming-calls, outgoing-calls via MCP or SKILLs CLI
  • Call Hierarchy: answer questions like "Who calls this procedure?" and "What does this procedure call?"
  • Run each bsl-language-server instance with custom JVM flags (large 1С projects may need more RAM allocation)
  • Run each bsl-language-server instance with its own configuration file (for example, with different diagnostic exclusions)
  • Run as a background service (optional)

Roadmap

  • Reduce verbosity of bsl-language-server responses

Release Package Contents

  • Two ready-to-use binaries lsp-skill-server and lsp-skill for respective platforms (Windows, Linux, MacOS arm and x64)
  • Two skills (with corresponding two MCPs):
    - 1c-check - for syntax checking
    - 1c-lsp - for code navigation (symbol search, definitions, references)
  • Sample mcp.json file for configuring MCP clients (IDE)
  • Sample AGENTS.md files to improve confidence in MCP or SKILLs CLI calls by LLM agents. Optional, but helpful with some models.

Quick Start

FAQ

Common questions

Discussion

Questions & comments · 0

Sign In Sign in to leave a comment.