АИ Финансист: MCP-сервер для 1С
mcp_1c (AI Финансист)
Связка MCP-сервера, OData-клиента 1С и локальной языковой модели с чатом на Gradio для вопросов по данным 1С и загруженным PDF
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- OData-клиент умеет не только читать, но и создавать, обновлять и удалять данные в базе 1С
- Логин и пароль от 1С хранятся в .env в открытом виде
Установка
Ручная установка
docker compose up --buildПеред запуском заполнить .env адресом OData 1С, логином и паролем, а также поднять vLLM отдельно.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Проект поднимает связку из четырех частей через docker compose: сервер vLLM с моделью Salesforce xLAM для разбора вызовов инструментов, MCP-сервер с инструментами для 1С поверх протокола OData, оркестратор, который сводит ответы модели и вызовы MCP, и веб-чат на Gradio. Клиент OData умеет читать, создавать, обновлять и удалять данные в базе 1С через стандартный интерфейс standard.odata. В чат можно также загружать PDF, текст из них достается модулем pdf_parser и попадает в контекст диалога вместе с данными 1С.
Для кого. Для 1С-разработчиков, которые хотят собственный локальный чат с доступом к данным 1С через OData, без облачных LLM-провайдеров.
Подходит, если
- Нужен полностью локальный стек: своя модель, свой MCP-сервер, свой чат, без внешних API
- Данные 1С доступны через стандартный OData standard.odata
- Хотите совместить вопросы по документам PDF и данным 1С в одном чате
Не подходит, если
- Нет мощности для локальной модели Salesforce xLAM-2-32b через vLLM
- Нужен MCP-сервер для подключения к Claude Code или Cursor, а не отдельный веб-чат
- База 1С не открывает OData или открывает по нестандартному пути
Пример запроса к агенту
Покажи остатки товара из справочника 1С и сравни их с таблицей из загруженного PDF-прайсаОграничения
Больше года нет обновлений и нет README про архитектуру MCP-инструментов, документация ограничена структурой проекта и переменными окружения. Требуется отдельно поднятый сервер vLLM с моделью Salesforce xLAM-2-32b, а это заметная нагрузка на GPU. Логин и пароль от базы 1С передаются переменными окружения в открытом виде в .env. Тип MCP-транспорта и авторизация в README не описаны, для точной настройки нужно смотреть исходники mcp_server.py.
Как отключить. Остановите стек командой docker compose down и удалите контейнеры проекта.
MCP
- Транспорт
- http
- Авторизация
- не нужна
| Переменные окружения | |
|---|---|
| MCP_1C_BASE обязательная | Адрес OData базы 1С, например http://host/TEST19/odata/standard.odata |
| ONEC_USERNAME обязательная | Логин пользователя 1С для подключения к OData |
| ONEC_PASSWORD обязательная, секрет | Пароль пользователя 1С, хранится в .env в открытом виде |
Проверка безопасности
- OData-клиент умеет не только читать, но и создавать, обновлять и удалять данные в базе 1С
- Логин и пароль от 1С хранятся в .env в открытом виде
Коротко о README
README дает структуру проекта: docker-compose.yml, gradio_app.py для чата, orchestrator.py как агент между LLM и MCP, mcp_server.py, odata_client.py и pdf_parser.py. Описан запуск vLLM с моделью Salesforce xLAM-2-32b на порту 8000, пример .env с адресами MCP и OData 1С, логином и паролем, и финальный запуск docker compose up --build с адресами Gradio UI и MCP-сервера.
Частые вопросы
Нужен ли доступ к облачным LLM?
Нет, README описывает запуск локальной модели Salesforce xLAM-2-32b через vLLM на своем железе.
Можно ли использовать это как обычный MCP-сервер для Claude Code?
README этого не описывает, проект собран как самодостаточный веб-чат с Gradio, а не как MCP-сервер для стороннего клиента.
Похожие
Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything