1C OData MCP Server
by pyrforio.github.alexgrebeshok-coder/onec-odata-mcpv1.0.1
Read-only MCP server for 1C:Enterprise via OData with metadata and query builder tools.
context tax
queued
security
queued
cold start
queued
freshness
Maintained2mo ago
Install 1C OData MCP server
Install in Claude Code
claude mcp add onec-odata -e ONEC_BASE_URL='<onec-base-url>' -e ONEC_USERNAME='<onec-username>' -e ONEC_PASSWORD='<onec-password>' -- npx -y onec-odata-mcpInstall in Cursor
{
"mcpServers": {
"onec-odata": {
"command": "npx",
"args": [
"-y",
"onec-odata-mcp"
],
"env": {
"ONEC_BASE_URL": "<onec-base-url>",
"ONEC_USERNAME": "<onec-username>",
"ONEC_PASSWORD": "<onec-password>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"onec-odata": {
"command": "npx",
"args": [
"-y",
"onec-odata-mcp"
],
"env": {
"ONEC_BASE_URL": "<onec-base-url>",
"ONEC_USERNAME": "<onec-username>",
"ONEC_PASSWORD": "<onec-password>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"onec-odata": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"onec-odata-mcp"
],
"env": {
"ONEC_BASE_URL": "<onec-base-url>",
"ONEC_USERNAME": "<onec-username>",
"ONEC_PASSWORD": "<onec-password>"
}
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"onec-odata": {
"command": "npx",
"args": [
"-y",
"onec-odata-mcp"
],
"env": {
"ONEC_BASE_URL": "<onec-base-url>",
"ONEC_USERNAME": "<onec-username>",
"ONEC_PASSWORD": "<onec-password>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| ONEC_BASE_URL | yes | — | 1C OData endpoint URL (e.g. https://host/db/odata/standard.odata) |
| ONEC_USERNAME | yes | — | Basic auth username for the OData endpoint |
| ONEC_PASSWORD | yes | yes | Basic auth password for the OData endpoint |
| ONEC_DATABASE | — | — | Optional database name hint |
| ONEC_METADATA_CACHE_TTL_MS | — | — | Metadata cache TTL in milliseconds (default 3600000) |
| ONEC_CONFIG_PATH | — | — | Optional path to JSON config file ({ baseUrl, username, password }) |
Freshness
Maintained — last maintenance signal 2mo ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-08-07 · 2mo ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-07-15 · 3mo ago · official registry · v1.0.1
FAQ
›How do I install the 1C OData MCP server in Claude Code?
Run: claude mcp add onec-odata -e ONEC_BASE_URL='<onec-base-url>' -e ONEC_USERNAME='<onec-username>' -e ONEC_PASSWORD='<onec-password>' -- npx -y onec-odata-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does 1C OData require an API key?
Yes. It expects ONEC_BASE_URL, ONEC_USERNAME, ONEC_PASSWORD, of which 1 is a secret.
›Can I use 1C OData as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is 1C OData in the official MCP registry?
Yes, as io.github.alexgrebeshok-coder/onec-odata-mcp.