1c-mcp
A TypeScript MCP server that reads 1C data through OData, read-only: entity search, entity cards, related records
Low risk
We rate an entry low when it mostly gives the agent instructions and reference material.
Why this level
- Tools only read data over OData; writing to 1C is not supported
Install
Manual install
pnpm install && cp .env.example .env && pnpm build && pnpm --filter @carely/1c-mcp startCommands from the README: install dependencies, copy the env config, build and start the server.
This is third-party code. Review the repository files before installing.
What it does
The server talks to 1C over OData and gives the agent read tools: listing available data sources, describing connection capabilities, searching entities, fetching an entity card and finding related records. It includes a healthcheck and a tool inventory. The author states this is an early version: some business logic from an earlier Python prototype has not been ported yet, and the project layout mirrors two of the author's other MCP servers.
Who it is for. For developers who want an agent to have safe, read-only access to 1C data over OData without any risk of writing to the database.
Good fit when
- You want an agent to read 1C catalogs and documents over OData with no write access
- Your 1C infobase already has an OData publication and you need an MCP bridge to it
- You need a starting point for your own TypeScript MCP on top of 1C
Not a fit when
- You need to write data into 1C: the server only reads
- You need ready business scenarios: the author notes prototype logic is not fully ported yet
- Your 1C infobase has no OData publication
Example request
Find a counterparty by name in 1C and show its related documentsLimitations
The project is at an early stage with no stars and no releases. It is read-only and never changes data in 1C. You need an OData publication configured on the 1C side and the environment variables from .env.example. Some business logic from the author's Python prototype has not been ported yet.
How to disable. Stop the server process and remove it from your MCP client configuration.
MCP
- Transport
- stdio
- Authentication
- API key
| Environment variables | |
|---|---|
| ONEC_INTERFACE_MODE | Set to mock for smoke tests without a real 1C base. |
Security check
- Tools only read data over OData; writing to 1C is not supported
README in short
The README describes a TypeScript MCP server for read-only access to 1C ERP over OData, gives pnpm quick-start commands, a mock mode for tests without a real base, and a list of seven tools: inventory, healthcheck, source listing, capability description, entity search, entity card and related-entity search.
FAQ
Can the server change data in 1C?
No, the README states the tools are read-only over OData.
Can I try the server without a real 1C base?
Yes, there is an ONEC_INTERFACE_MODE=mock mode for smoke tests without real 1C credentials.
Related
A skills library that gives coding agents a development process: brainstorming, planning, TDD, subagents and code review
Skills for real engineers by Matt Pocock
Skills For Real Engineers
Small composable skills for engineering with agents: plan grilling, TDD, bug diagnosis, code review and architecture
GitHub toolkit for spec-driven development: the specify CLI adds agent commands and skills to a project, from principles to implementation
Reference MCP servers
Model Context Protocol servers
Official reference MCP servers: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time and Everything