MCP server for 1C:Naparnik
Spring Boot MCP Server для 1С:Напарник
Spring Boot and Kotlin MCP server that connects an agent to the 1C:Naparnik API for 1C questions and code checks
- 47 ★ on the repository
- Last commit
Extended access
Why this level
- Requires a 1C:Naparnik token
- Code sent for checks goes to an external API
- Runs a Docker container with an HTTP server
Install
- Works in
- Services
Manual install
cp env.example .env
./scripts/prepare-token-secret.sh
docker build -f Dockerfile.build -t spring-mcp-1c-copilot .
docker compose up -dPaste the token into the ONEC_AI_TOKEN line in .env before running the script.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Requires a 1C:Naparnik token
- Code sent for checks goes to an external API
- Runs a Docker container with an HTTP server
This is third-party code. Review the repository files before installing.
What it does
Proxies agent requests to the 1C:Naparnik API at code.1c.ai. It provides three tools: ask_1c_ai for questions, explain_1c_syntax for syntax explanations and check_1c_code for syntax, logic and performance checks. It runs over Streamable HTTP or SSE and also exposes a REST API and Swagger UI.
Who it is for. 1C developers with 1C:Naparnik access who code in Cursor or Codex.
Good fit when
- You want a 1C platform reference answer inside the agent
- Check a 1C code fragment for errors and performance
- Explain an unfamiliar element of the 1C language
Not a fit when
- You have no 1C:Naparnik token
- You plan commercial use without the author's permission
Example request
Check this 1C code for performance issues and explain what the ВыполнитьПакет method doesMCP
- Transport
- http, sse
- Authentication
- API key
Environment variables
ONEC_AI_TOKENrequired, secret- Access token for the 1C:Naparnik API
ONEC_AI_TOKEN_FILE- Path to a token file used instead of ONEC_AI_TOKEN
ONEC_AI_BASE_URL- API base URL, default https://code.1c.ai
ONEC_AI_SKILL_NAME- Naparnik session mode, default raw
SSE_PORT- Server port, default 8000
Limitations
Requires a 1C:Naparnik token from code.1c.ai. Needs Java 17 or Docker. Docker Compose attaches the container to an external infra network by default, so outside the author's sandbox you have to set up networking yourself. The license allows personal and non-commercial use only.
How to disable. Remove the 1c-copilot-proxy block from ~/.cursor/mcp.json and stop the container with docker compose down.
FAQ
How should the token be stored?
./scripts/prepare-token-secret.sh moves it from .env into .secrets/onec_ai_token, referenced by ONEC_AI_TOKEN_FILE.
Why raw mode?
ONEC_AI_SKILL_NAME=raw is the default because it is more stable for reference answers and avoids internal tool_calls.
Discussion
No questions or reviews yet.
Related
All 1C:Enterprise tools1C AI Assistant MCP proxy
1c-ai-mcp
An MCP server that forwards questions, code review and code explanation requests to the 1C AI Assistant cloud service
1C AI MCP: 1C:Naparnik API bridge
1C AI MCP
A FastMCP Docker server with 12 tools for BSL code analysis and documentation search through the 1С:Naparnik API (code.1c.ai)
An MCP server that exposes the cloud 1C:Napparnik (1C.ai) assistant and a local BSL Language Server to agents in Cursor and other IDEs
1C:Naparnik MCP bridge in Go
1c-copilot-mcp
A Go binary with 5 MCP tools for the 1С:Naparnik neural network that reads 1C code straight from a file path instead of through the model's context
A 1C external data processor with MCP and REST API: queries, metadata, event log and code execution without changing the configuration
1C MCP Server with a FastAPI proxy
1C MCP Server
A 1C extension with an MCP HTTP service plus a Python FastAPI proxy that adds stdio transport, OAuth2 and Docker deployment
Comparison with similar tools
Entries that share the main search query, and how they differ.
| Entry | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| MCP server for 1C:Naparnik (this entry) | no | API key | 47 | |
| browser-use-mcp-server | no | API key | 849 | drives a browser through Playwright |
| Kommo CRM MCP server | no | OAuth | 0 | in Python, with OAuth for Kommo |
| MCP server for the GigaChat API | no | API key | 0 | a small server for Sber's GigaChat API |
README in short
The project is a Spring Boot and Kotlin MCP server for 1C:Naparnik that builds on artesk/1copilot_MCP and rentgengl/copilot-1c-proxy. It documents three MCP tools, REST endpoints and Swagger UI. It covers running locally with Gradle, running in Docker, environment variables and Cursor setup. Storing the token in a file is described separately.