About io.github.theYahia/1c-rest-mcp
io.github.theYahia/1c-rest-mcp is an MCP server in the Security category: mCP server for 1C REST API -- catalogs, documents. Basic Auth, configurable base URL.
Install
claude mcp add io-github-theyahia-1c-rest-mcp -- npx -y @theyahia/1c-rest-mcpnpx -y @theyahia/1c-rest-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about io.github.theYahia/1c-rest-mcp
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
README
@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
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.