1c-rest-mcp

mcp
Security Audit
Warn
Health Warn
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 6 GitHub stars
Code Warn
  • process.env — Environment variable access in src/client.ts
  • network request — Outbound network request in src/client.ts
  • process.env — Environment variable access in src/http.ts
  • process.env — Environment variable access in src/index.ts
  • process.env — Environment variable access in src/server.ts
Permissions Pass
  • Permissions — No dangerous permissions requested

No AI report is available for this listing yet.

SUMMARY

MCP server for 1C Enterprise — ERP catalogs, documents via REST (Russia). Part of WWmcp — 114 MCP servers for emerging markets.

README.md

⚠️ Moved / Deprecated

This repository is deprecated and frozen at v1.2.1 (9 tools). @theyahia/1c-rest-mcp is now
developed in theYahia/WWmcp
(v3.x — 32 tools, MCP prompts, batch ops, change-tracking, OData injection hardening).

Install: npx -y @theyahia/1c-rest-mcp · Issues & PRs → the monorepo.


@theyahia/1c-rest-mcp

MCP-сервер для REST API 1С:Предприятие через OData 3.0 -- справочники, документы, регистры, отчёты.

Инструменты (9)

Инструмент Описание
list_entities Получить список доступных сущностей OData (справочники, документы, регистры)
get_document_by_number Найти документ по номеру и типу (например, СчётФактура №УТ-001)
get_catalogs Чтение справочников через OData ($filter, $select, $orderby, $top, $skip)
get_documents Чтение документов через OData с фильтрацией
create_document Создание документа (POST)
update_document Обновление документа (PATCH по Ref_Key)
get_register Чтение регистров сведений и накопления
get_report Получение отчёта по произвольному URL HTTP-сервиса
odata_query Произвольный OData-запрос с $expand, $inlinecount

Skills

Skill Описание
skill-catalog Быстрый поиск по справочнику (обёртка над get_catalogs)
skill-documents Запрос документов по типу и датам (обёртка над get_documents)

Настройка (stdio)

{
  "mcpServers": {
    "1c": {
      "command": "npx",
      "args": ["-y", "@theyahia/1c-rest-mcp"],
      "env": {
        "ONEC_BASE_URL": "http://server:8080/base",
        "ONEC_LOGIN": "логин",
        "ONEC_PASSWORD": "пароль"
      }
    }
  }
}

Фильтрация модулей (ONEC_SERVICES)

Чтобы ограничить набор инструментов (например, для экономии контекста LLM):

ONEC_SERVICES=catalogs,documents npx @theyahia/1c-rest-mcp

Доступные модули: catalogs, documents, registers, reports, odata, meta. По умолчанию (all) — все инструменты активны. Инструменты list_entities и get_document_by_number доступны всегда.

Streamable HTTP

ONEC_BASE_URL=http://server:8080/base \
ONEC_LOGIN=admin \
ONEC_PASSWORD=secret \
npx @theyahia/1c-rest-mcp-http
# или: node dist/http.js
# Слушает POST /mcp, GET /health на порту 3000 (PORT=3000)

Переменные окружения

Переменная Обязательна Описание
ONEC_BASE_URL Да Базовый URL сервера 1С (например http://localhost:8080/base)
ONEC_LOGIN Да Логин для HTTP Basic Auth
ONEC_PASSWORD Да Пароль для HTTP Basic Auth
ONEC_SERVICES Нет Список модулей через запятую (по умолчанию: all)

Обратная совместимость: старые имена 1C_BASE_URL, 1C_LOGIN, 1C_PASSWORD тоже поддерживаются.

Smithery

Файл smithery.yaml включён для деплоя на Smithery.

Лицензия

MIT

Reviews (0)

No results found