MCP-сервер и Telegram-бот для BAS OData
mcp_claude_1c
Stdio MCP-сервер поверх OData BAS с whitelist сущностей, FastAPI-прослойкой, Telegram-ботом на Claude или Groq и мониторингом через Grafana и Loki
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- MCP-инструмент create пишет новые документы в базу BAS для заданных сущностей
- Telegram-токен и ключи LLM-провайдера хранятся в .env
Установка
Ручная установка
docker compose upПоднимает FastAPI, MCP-сервер недоступен по HTTP напрямую, Telegram-бота и стек мониторинга. Перед запуском заполнить .env.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Проект дает агенту доступ к базе BAS (учетная платформа семейства 1С:Предприятие, используемая на Украине и в СНГ) через OData. MCP-сервер при старте запрашивает $metadata у FastAPI-сервиса, отфильтровывает сущности по BAS_ENTITY_WHITELIST и динамически генерирует инструменты query и create с операциями по типу сущности: справочники поддерживают поиск, документы только список и получение по id. Отдельный Telegram-бот на aiogram использует те же инструменты и работает с выбранной через фабрику моделью, Claude или Groq. Логи сервисов уходят в Loki через Promtail и доступны в Grafana.
Для кого. Для разработчиков, которые интегрируют агента с базой BAS через OData и хотят готовый Telegram-интерфейс поверх нее.
Подходит, если
- База OData у вас на платформе BAS с сущностями вроде Document_АктВыполненныхРабот
- Хотите ограничить агента белым списком сущностей вместо доступа ко всей базе
- Нужен Telegram-бот с доступом к тем же MCP-инструментам, что и агент
Не подходит, если
- Ваша база не на BAS и не отдает OData $metadata в совместимом формате
- Нужна работа полностью без внешних LLM: обе опции LLM_PROVIDER, Claude и Groq, требуют облачного API-ключа
- README в репозитории пуст, самостоятельная настройка потребует чтения исходников
Пример запроса к агенту
Через Telegram-бота найди в BAS акт выполненных работ за прошлый месяц по конкретному контрагентуОграничения
README в репозитории пустой, вся информация об установке и переменных окружения собрана по исходному коду и docker-compose.yml. Часть комментариев в коде на украинском языке. Нужны ключи ANTHROPIC_API_KEY или GROQ_API_KEY в зависимости от LLM_PROVIDER, оба зарубежных облачных провайдера. Операция create в MCP-сервере жестко ограничена двумя сущностями в коде, для других нужно менять исходники.
Как отключить. Остановите стек командой docker compose down, для Telegram-бота отдельно остановите сервис bot.
MCP
- Транспорт
- stdio
- Авторизация
- не нужна
| Переменные окружения | |
|---|---|
| FASTAPI_URL обязательная | Адрес FastAPI-сервиса, который MCP-сервер запрашивает за метаданными и данными |
| BAS_ENTITY_WHITELIST | Список сущностей BAS через запятую с поддержкой масок, пусто значит все сущности |
| LLM_PROVIDER обязательная | claude или groq, определяет, какой облачный ключ нужен боту |
| TELEGRAM_BOT_TOKEN обязательная, секрет | Токен Telegram-бота от BotFather, нужен только для запуска бота |
Проверка безопасности
- MCP-инструмент create пишет новые документы в базу BAS для заданных сущностей
- Telegram-токен и ключи LLM-провайдера хранятся в .env
Коротко о README
У репозитория пустой README, поэтому назначение проекта восстановлено по структуре кода: docker-compose.yml поднимает FastAPI-сервис, MCP-сервер, Telegram-бота и стек мониторинга Loki, Promtail и Grafana; pyproject.toml перечисляет зависимости aiogram, anthropic, groq, mcp и fastapi; докстринги в mcp_server/server.py и llm/factory.py описывают логику генерации инструментов и выбора провайдера LLM.
Частые вопросы
Это MCP-сервер именно для российского 1С?
Нет, судя по коду и именам сущностей это BAS: платформа семейства 1С:Предприятие, которую используют на Украине и в СНГ. Название репозитория содержит 1c, но сама база не российская.
Можно ли работать без Claude или Groq?
По исходникам фабрики llm/factory.py поддерживаются только эти два провайдера, оба облачные и зарубежные.
Похожие
Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything