MCP.Market

1C OData MCP server

by alexgrebeshok-coder·io.github.alexgrebeshok-coder/onec-odata-mcp·v1.0.1
No reviews yet

Read-only MCP server for 1C:Enterprise via OData with metadata and query builder tools.

B72/100grade B
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
B72/100

full report

Adoption
New

0 stars43 downloads/wk

Reviews

Write one

Nobody has reviewed 1C OData MCP yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

1C OData MCP tools (8)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • odata_build_query

    Build validated OData query parameters from structured intent (filters, date period, sort, top). Returns params for odata_query + human explanation.

  • odata_config

    Check 1С OData configuration status and setup instructions

  • odata_count

    Count records in an OData entity, optionally with filter

  • odata_explain_entity

    Describe entity fields, types, keys and navigation properties from metadata

  • odata_financial_summary

    Auto-detect common 1С financial entities (счета, реализации, контрагенты, заявки) and show counts

  • odata_list_entities

    List all available OData entities from 1С

  • odata_metadata

    Get entity types and entity sets from 1С metadata (cached, TTL default 1h)

  • odata_query

    Query 1С OData entity with filter, select, top, orderBy, expand. Example: entity="Catalog_Контрагенты" filter="Description eq 'ООО Ромашка'"

Public scan report

scanner v0.1.9 · 2026-09-25 · same rubric, same numbers if you re-run it

no findings
  • Code scan36 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitystatic API keys via environment variables6/15
  • Maintenancelast push 49 days ago12/15
  • Maintainer identitynamespace and repository owner differ4/10
Overall 72/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How 1C OData MCP compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
72/100
higher than 38% of 48,255 servers
Tools
8
the typical server has 7
Tools that change things
0%
typical: 0%. Fewer write tools means less an agent can break
Downloads a week
43
more than 35% of 12,191 servers with a package

What its tools let an agent do: 8 read

Install 1C OData MCP in Claude Code, Cursor or VS Code

Runs npx -y onec-odata-mcp on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add onec-odata-mcp -- npx -y onec-odata-mcp
Add to Cursor

What the publisher says

From the 1C OData MCP repository's README, as published. We do not edit it. Read it on GitHub

onec-odata-mcp

Подключи 1С к Claude за 5 минут

Даёт Claude (Desktop, Code, любой MCP-клиент) доступ на чтение к базе 1С:Предприятие через стандартный OData. Вместо выгрузки в Excel или ручного написания OData-урлов — спрашиваешь по-русски, получаешь структурированные данные из справочников и документов.

Работает с любой конфигурацией 1С, где опубликован OData (Бухгалтерия, ERP, Управление торговлей, самописные конфигурации).

📸 TODO: скриншот/видео 5-минутной настройки — добавить после первого прогона с реальной базой.

Шаг 1 — установка

Ничего ставить локально не нужно, npx подтянет пакет при первом запуске:

One-liner (after npm publish):

npx -y onec-odata-mcp

Set ONECBASEURL, ONECUSERNAME, and ONECPASSWORD in your MCP client config (see below).

From source:

npx -y onec-odata-mcp

(Для разработки из исходников: npm install && npm run build.)

Шаг 2 — подключи к Claude

Вариант А — командой claude mcp add (Claude Code):

claude mcp add onec-odata \
  -e ONEC_BASE_URL=https://1c.example.com/your_db/odata/standard.odata \
  -e ONEC_USERNAME=odata_user \
  -e ONEC_PASSWORD=your_password \
  -- npx -y onec-odata-mcp

Вариант Б — вручную в claudedesktopconfig.json (Claude Desktop: Settings → Developer → Edit Config):

{
  "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"
      }
    }
  }
}

Готовый сниппет лежит в examples/claudedesktopconfig.json.

Опционально: ONECDATABASE (подсказка имени базы), ONECMETADATACACHETTLMS (TTL кэша метаданных, по умолчанию 1 час), ONECWRITABLE=true (разрешить реальную запись через odatawrite; по умолчанию false). Либо вместо переменных окружения — JSON-файл ~/.onec-odata/onec-config.json с полями baseUrl, username, password (и опционально "writable": true), путь к которому задаётся через ONECCONFIG_PATH.

Шаг 3 — первый запрос

Перезапусти Claude и спроси:

«Какие справочники и документы есть в базе 1С?»

Claude вызовет odatalistentities, увидит список и дальше сам подберёт нужные инструменты под конкретный вопрос — без знания синтаксиса OData с твоей стороны.

Больше готовых промптов — в examples/prompts.md.

Инструменты

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

1C OData MCP: common questions

Is 1C OData MCP server safe?
Mostly: it is graded B (72/100). Read the 1C OData MCP safety report
How do I install 1C OData MCP?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does 1C OData MCP need an API key?
Yes. The registry entry asks for ONEC_PASSWORD.
Is 1C OData MCP maintained?
The last commit was 89 days ago (2026-08-07). The latest release is v1.0.1.
How does 1C OData MCP compare with other MCP servers?
safety score 72/100 (higher than 38% of 48,255 servers); tools 8 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.