MCP server for 1C REST API -- catalogs, documents. Basic Auth, configurable base URL.
Config is the same across clients — only the file and path differ.
{
"mcpServers": {
"1c": {
"env": {
"ONEC_LOGIN": "логин",
"ONEC_BASE_URL": "http://server:8080/base",
"ONEC_PASSWORD": "пароль"
},
"args": [
"-y",
"@theyahia/1c-rest-mcp"
],
"command": "npx"
}
}
}Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
MCP-сервер для REST API 1С:Предприятие через OData 3.0 -- справочники, документы, регистры, отчёты.
Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.
npx -y '@theyahia/1c-rest-mcp' 2>&1 | head -1 && echo "✓ Server started successfully"
After testing, let us know if it worked:
Five weighted categories — click any category to see the underlying evidence.
No known CVEs.
Checked @theyahia/1c-rest-mcp against OSV.dev.
Click any tool to inspect its schema.
Be the first to review
Have you used this server?
Share your experience — it helps other developers decide.
Sign in to write a review.
Others in data / developer-tools
Query and manage PostgreSQL databases directly from AI assistants
A Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.
Workspace template + MCP server for Claude Code, Codex CLI, Cursor & Windsurf. Multi-agent knowledge engine (ag-refresh / ag-ask) that turns any codebase into a queryable AI assistant.
MCP server for accessing Figma plugin console logs and screenshots via Cloudflare Workers or local mode
MCP Security Weekly
Get CVE alerts and security updates for io.github.theYahia/1c-rest-mcp and similar servers.
Start a conversation
Ask a question, share a tip, or report an issue.
Sign in to join the discussion.
MCP-сервер для REST API 1С:Предприятие через OData 3.0 -- справочники, документы, регистры, отчёты.
| Инструмент | Описание |
|---|---|
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 |
| Skill | Описание |
|---|---|
skill-catalog | Быстрый поиск по справочнику (обёртка над get_catalogs) |
skill-documents | Запрос документов по типу и датам (обёртка над get_documents) |
{
"mcpServers": {
"1c": {
"command": "npx",
"args": ["-y", "@theyahia/1c-rest-mcp"],
"env": {
"ONEC_BASE_URL": "http://server:8080/base",
"ONEC_LOGIN": "логин",
"ONEC_PASSWORD": "пароль"
}
}
}
}
Чтобы ограничить набор инструментов (например, для экономии контекста LLM):
ONEC_SERVICES=catalogs,documents npx @theyahia/1c-rest-mcp
Доступные модули: catalogs, documents, registers, reports, odata, meta. По умолчанию (all) — все инструменты активны. Инструменты list_entities и get_document_by_number доступны всегда.
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.yaml включён для деплоя на Smithery.
MIT