Back to Browse
Free
Server data from the Official MCP Registry
Read-only MCP server for 1C:Enterprise via OData with metadata and query builder tools.
About
Read-only MCP server for 1C:Enterprise via OData with metadata and query builder tools.
Security Report
4.8
Use Caution4.8High RiskThis is a well-structured MCP server for querying 1C:Enterprise OData endpoints with proper authentication, input validation, and metadata-driven query building. Credentials are correctly managed via environment variables. The codebase demonstrates good security practices with field validation against live metadata, fuzzy matching to prevent typos, and explicit secret field filtering. Minor code quality issues exist but do not introduce security vulnerabilities. Supply chain analysis found 7 known vulnerabilities in dependencies (1 critical, 3 high severity). Package verification found 1 issue.
7 files analyzed · 13 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
What You'll Need
Set these up before or after installing:
1C OData endpoint URL (e.g. https://host/db/odata/standard.odata)
Environment variable: ONEC_BASE_URL
Basic auth username for the OData endpoint
Environment variable: ONEC_USERNAME
Basic auth password for the OData endpointRequired
Environment variable: ONEC_PASSWORD
Optional database name hint
Environment variable: ONEC_DATABASE
Metadata cache TTL in milliseconds (default 3600000)
Environment variable: ONEC_METADATA_CACHE_TTL_MS
Optional path to JSON config file ({ baseUrl, username, password })
Environment variable: ONEC_CONFIG_PATH
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-alexgrebeshok-coder-onec-odata-mcp": {
"env": {
"ONEC_BASE_URL": "your-onec-base-url-here",
"ONEC_DATABASE": "your-onec-database-here",
"ONEC_PASSWORD": "your-onec-password-here",
"ONEC_USERNAME": "your-onec-username-here",
"ONEC_CONFIG_PATH": "your-onec-config-path-here",
"ONEC_METADATA_CACHE_TTL_MS": "your-onec-metadata-cache-ttl-ms-here"
},
"args": [
"-y",
"onec-odata-mcp"
],
"command": "npx"
}
}
}Documentation
View on GitHubFrom the project's GitHub README.
onec-odata-mcp
MCP server bridging AI agents to 1C:Enterprise (1С:Предприятие) via OData.
Give an AI assistant (Claude Desktop, Cursor, any MCP client) read-only access to a 1C database. Instead of exporting spreadsheets or hand-writing OData URLs, the agent queries 1C entities — counterparties, documents, invoices, catalogs — in natural language and gets structured data back. Works with any 1C configuration that exposes the standard OData endpoint (Accounting, ERP, Trade Management, and custom configs).
Quick start
npm install
npm run build
Configure via environment variables (recommended for MCP clients):
ONEC_BASE_URL=https://1c.example.com/your_db/odata/standard.odata
ONEC_USERNAME=odata_user
ONEC_PASSWORD=odata_password
# optional:
ONEC_DATABASE=your_db
ONEC_METADATA_CACHE_TTL_MS=3600000
Register the server in your MCP client (e.g. Claude Desktop claude_desktop_config.json):
{
"mcpServers": {
"onec-odata": {
"command": "npx",
"args": ["-y", "onec-odata-mcp"],
"env": {
"ONEC_BASE_URL": "https://1c.example.com/your_db/odata/standard.odata",
"ONEC_USERNAME": "odata_user",
"ONEC_PASSWORD": "your_password"
}
}
}
}
Alternatively, place a JSON file at ~/.onec-odata/onec-config.json with { "baseUrl", "username", "password" } and point ONEC_CONFIG_PATH at it.
Tools
| Tool | Description |
|---|---|
odata_config | Check configuration status and setup instructions |
odata_list_entities | List all available OData entities |
odata_metadata | Get entity types and sets from $metadata (cached, 1h TTL) |
odata_explain_entity | Describe an entity's fields, types, keys, navigation properties |
odata_build_query | Build a validated $filter/$select/$orderby from structured intent |
odata_query | Query an entity with raw OData params (filter/select/top/expand) |
odata_count | Count records in an entity, optionally filtered |
odata_financial_summary | Auto-detect common financial entities and report their counts |
Example
Ask the agent: "How many sales orders were posted this month?"
It calls odata_build_query → odata_count on the sales-order entity with a date filter. No OData syntax knowledge required — the server validates fields against live $metadata and rejects unknown/secret fields.
Requirements
- Node.js ≥ 18
- 1C:Enterprise with the OData endpoint published (web publishing →
standard.odata)
License
MIT
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
80.0K
Stars
7
Installs
6.5
Security
No ratings yet
Local
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
137
Stars
544
Installs
8.0
Security
4.8
Local
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
-
Stars
82
Installs
10.0
Security
4.6
Local