
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.
概覽
唯讀的 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。
安裝
在 SourceWeft 中
- 開啟 儀表板中的 1C OData MCP,將其新增到工作區。
- 為需要使用其工具的對話啟用該服務。
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):
Set ONEC_BASE_URL, ONEC_USERNAME, and ONEC_PASSWORD in your MCP client config (see below).
From source:
(Для разработки из исходников: npm install && npm run build.)
Шаг 2 — подключи к Claude
Вариант А — командой claude mcp add (Claude Code):
Вариант Б — вручную в claude_desktop_config.json (Claude Desktop: Settings → Developer → Edit Config):
Готовый сниппет лежит в 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_build_query → odata_query/odata_count, тебе достаточно спросить своими словами.
Безопасность
- По умолчанию только чтение. Флаг
writableв конфиге базы (envONEC_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)
Разработка
Детали и правила вклада — в 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.
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版本歷史
1- v1.0.1最新Sep 16, 2026
評分
已滿足適用檢查項的 50%
該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。
- 近 30 天內可連通25 分
請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。
- 已宣告認證方式10 分
請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。
- 已列出工具15 分
請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。
- 描述必需15 分
- 圖示10 分
- 文件15 分
- 授權條款10 分
