http1c: MCP server framework for 1C
http1c
A native component that runs a full MCP server inside 1C: tools, resources and prompts are written in BSL, while a DLL handles the protocol
- 44 ★ on the repository
- Last commit
- MIT
Broad access
Why this level
- The demo execute tool runs arbitrary 1C code on the server or thin client
- Authentication is off by default; anyone reaching the port gets access to every tool
Install
- Works in
- Services
Manual install
build/build-http1c-dll-release.shBuilds the native component and packages the add-in, requires Visual Studio Build Tools 2019+.
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- The demo execute tool runs arbitrary 1C code on the server or thin client
- Authentication is off by default; anyone reaching the port gets access to every tool
This is third-party code. Review the repository files before installing.
What it does
http1c splits responsibility into two layers: the native component (DLL) handles the MCP transport over Streamable HTTP and SSE, session management, Bearer-token authentication, pagination and notifications, while the 1C side in BSL describes the specific tools, resources and prompts and handles calls via ExternalEvent. It ships with a demo external data processor with example tools: execute (running arbitrary code), evaluate, query, openForm and getStatus. Optionally, a built-in semantic search (RAG) subsystem runs on a Rust rcore engine with hybrid (dense plus keyword) retrieval that indexes any 1C content with no external services, plus a ready MCPRagSearch integration for Vanessa Automation that exposes VA's whole MCP contract along with search over its step catalog and knowledge base.
Who it is for. For 1C developers who want to expose their configuration's business logic to agents over MCP without dealing with HTTP, JSON-RPC and SSE themselves.
Good fit when
- You need an MCP server over your own 1C configuration with custom BSL tools
- You need semantic search over documentation, code, catalog descriptions or logs with no external vector store
- You write Vanessa Automation tests and want an agent to rely on the real step catalog via search rather than inventing steps
Not a fit when
- You have no Windows and no Visual Studio Build Tools to build the native component
- You need ready-made functionality rather than something you describe yourself: this is a framework, not a set of ready tools
- You are not ready to explicitly restrict the execute tool, which runs arbitrary 1C code
Example request
Open the Nomenclature catalog form and find, by meaning, the Vanessa steps for verifying new element creationMCP
- Transport
- sse, http
- Authentication
- API key
Limitations
The native component can only be built on Windows with MSVC. The HTTP server is intentionally local-only, binding to 127.0.0.1. The authors themselves describe the demo's execute and evaluate tools as powerful server capabilities to be used only in a trusted local environment. A full build with semantic search (rcore.dll) requires Rust, and GPU acceleration via DirectML depends on a Windows system library.
How to disable. Detach the component in the http1c.epf form (StopListen) or close the processing, and remove the server from your client's mcp.json.
FAQ
Is semantic search mandatory to build?
No, by default the lite version without the Rust core is built; search can be added separately with the -DRCORE_FASTEMBED=ON flag.
Do you need to write C++ code for new tools?
No, new tools, resources and prompts are described in BSL and registered with the component; the transport layer does not need to be touched.
Discussion
No questions or reviews yet.
Related
All 1C:Enterprise toolsA 1C extension that runs an MCP server inside the 1C:Enterprise client and lets you write your own tools in BSL
A 1C extension built on vladimir-kharin/1c_mcp that adds execution of arbitrary built-in-language code right in the infobase context
MCP server inside 1C
1c_mcp
A 1C extension that runs an MCP server inside the infobase: metadata tools out of the box and custom tools in BSL
Unified 1C MCP gateway with a dashboard
onec-mcp-universal
A Docker gateway with one address instead of several MCP connections: 1C data, BSL navigation, ITS search via 1C:Napparnik, and a web dashboard
A 1C external data processor with MCP and REST API: queries, metadata, event log and code execution without changing the configuration
Ten MCP servers for 1C development: platform reference, targeted object dump and load, COM, storage, file search and BSL Language Server
README in short
The README describes in detail the architecture and division of responsibility between the DLL and 1C, the full list of native methods and ExternalEvent events, supported MCP protocol methods, the demo processing's reference tools, resources and prompts, Bearer authentication setup, the design and rationale of the RAG semantic search subsystem on rcore with a table of design decisions, the differences between lite and full builds, Vanessa Automation integration via the MCPRagSearch plugin, Windows build requirements, and known limitations.