1C OData MCP

io.github.alexgrebeshok-coder由 GitHub 帳號 alexgrebeshok-coder 發布v1.0.1更新於 Oct 28, 2026

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

已驗證STDIO僅桌面資料庫商業與電商

概覽

AI 產生的概覽

唯讀的 MCP 伺服器,讓助理透過標準 OData 介面瀏覽與查詢 1C:Enterprise 資料庫。

可以做什麼
  • 檢查連線狀態與設定
  • 列出可用的 OData 實體,並檢視中繼資料、欄位、型別、主鍵與關聯
  • 依結構化輸入建立並驗證 OData 的 filter、select 與 orderby 參數
  • 查詢實體並統計記錄數量,可加上篩選條件
  • 透過寫入工具建立、修改或刪除實體,預設先預覽
  • 彙整帳戶、銷售、往來對象等典型財務實體
適用情境
適用於已發佈 OData 介面的 1C:Enterprise 系統(會計、ERP、貿易管理或自製組態),想用自然語言提問而不必匯出試算表或手寫 OData 網址時使用。
執行需求
透過 npx 在本機執行,需要 Node.js 18 或更新版本。需要已發佈 OData 介面的 1C:Enterprise 資料庫,以及 ONEC_BASE_URL、ONEC_USERNAME、ONEC_PASSWORD(或由 ONEC_CONFIG_PATH 指定的 JSON 設定檔)。選用:ONEC_DATABASE、ONEC_METADATA_CACHE_TTL_MS、ONEC_WRITABLE。
安裝前請注意
ONEC_PASSWORD 中的密碼會以 Basic Auth 隨每個請求送出,並可能存放在 MCP 用戶端設定或本機設定檔中。預設為唯讀;只有在啟用 ONEC_WRITABLE 且寫入呼叫明確將 dryRun 設為 false 時,才會真正送出 POST、PATCH、DELETE 請求,可寫入的帳號可能修改或刪除業務資料。日常使用建議設定專用的唯讀 OData 使用者。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 1C OData MCP,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

onec-odata-mcp

[npm] [MCP Registry] [License: MIT]

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

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

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

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

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

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

One-liner (after npm publish):

bash
npx -y onec-odata-mcp

Set ONEC_BASE_URL, ONEC_USERNAME, and ONEC_PASSWORD in your MCP client config (see below).

From source:

bash
npx -y onec-odata-mcp

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

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

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

bash
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

Вариант Б — вручную в claude_desktop_config.json (Claude Desktop: Settings → Developer → Edit 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"      }    }  }}

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

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

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

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

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

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

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

Инструменты

ИнструментЧто делаетПример вопроса
odata_configПроверяет статус подключения и настройки«Проверь, подключена ли 1С»
odata_list_entitiesСписок всех доступных OData-сущностей«Какие справочники и документы есть в базе?»
odata_metadataТипы и наборы сущностей из $metadata (кэш, TTL 1ч)вызывается автоматически перед сложными запросами
odata_explain_entityПоля, типы, ключи, связи конкретной сущности«Какие поля у справочника Контрагенты?»
odata_build_queryСтроит и проверяет $filter/$select/$orderby из структурированных параметров запросавызывается автоматически — Claude сам переводит «за июнь» в даты, тул собирает и валидирует фильтр
odata_queryЗапрос к сущности с готовыми OData-параметрами«Покажи остатки по счёту 51 за июнь»
odata_countКоличество записей, опционально с фильтром«Сколько контрагентов зарегистрировано в этом году?»
odata_writeСоздание/изменение/удаление сущности (POST/PATCH/DELETE)«Создай контрагента…» — сначала dry-run-превью
odata_financial_summaryАвтообнаружение типовых финансовых сущностей + счётчики«Дай сводку по счетам, реализациям и контрагентам»

Обычно агент сам комбинирует odata_build_query → odata_query/odata_count, тебе достаточно спросить своими словами.

Безопасность

  • По умолчанию только чтение. Флаг writable в конфиге базы (env ONEC_WRITABLE=true / "writable": true в ~/.onec-odata/onec-config.json) по умолчанию false. Без него реальные POST/PATCH/DELETE не уходят в 1С.
  • Запись — только через odata_write. У инструмента dryRun по умолчанию true: всегда сначала превью {dryRun: true, wouldExecute: …} без сетевого вызова. Реальная запись требует и writable: true на этой базе, и явного dryRun: false.
  • Пароль передаётся Basic Auth (base64 в заголовке каждого запроса — как требует OData) и хранится либо в env-переменных конфига твоего MCP-клиента (рекомендуется), либо в локальном файле ~/.onec-odata/onec-config.json. Сервер не логирует и не возвращает пароль в ответах инструментов.
  • Поля-секреты (password, token, apikey, secret и т.п. в названиях) автоматически исключены из подсказок «возможно, вы имели в виду» (src/query/fuzzy.ts), чтобы агент не подсвечивал их случайно.
  • Рекомендация: заведи в 1С отдельного OData-пользователя с ролью только на чтение для обычной работы; writable-учётку и ONEC_WRITABLE=true включай только осознанно.

Требования

  • Node.js ≥ 18
  • 1С:Предприятие с опубликованным OData-интерфейсом (веб-публикация → standard.odata)

Разработка

bash
npm installnpm run build   # type-check + сборка в dist/npm test

Детали и правила вклада — в CONTRIBUTING.md.

License

MIT


English (short)

MCP server giving Claude (or any MCP client) access to a 1C:Enterprise database via its standard OData endpoint. Read-only by default (writable: false); writes go through odata_write and always dry-run first unless you explicitly enable writable: true and pass dryRun: false. No spreadsheet exports, no hand-written OData URLs — ask in natural language, get structured data from catalogs and documents.

bash
npx -y onec-odata-mcp

Configure via ONEC_BASE_URL / ONEC_USERNAME / ONEC_PASSWORD env vars (see the Russian quick-start above for claude mcp add and claude_desktop_config.json snippets — the JSON is language-agnostic). Optional: ONEC_WRITABLE=true to allow real writes. Published on npm as onec-odata-mcp and listed in the official MCP Registry as io.github.alexgrebeshok-coder/onec-odata-mcp.

來源:README.md,提交 97a7f25

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包,因此其工具未知。

版本歷史

1
  1. v1.0.1最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分