MCP-сервер и Telegram-бот для BAS OData
mcp_claude_1c
Stdio MCP-сервер поверх OData BAS с whitelist сущностей, FastAPI-прослойкой, Telegram-ботом на Claude или Groq и мониторингом через Grafana и Loki
- 0 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- MCP-инструмент create пишет новые документы в базу BAS для заданных сущностей
- Telegram-токен и ключи LLM-провайдера хранятся в .env
Установка
- Работает в
Ручная установка
docker compose upПоднимает FastAPI, MCP-сервер недоступен по HTTP напрямую, Telegram-бота и стек мониторинга. Перед запуском заполнить .env.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- MCP-инструмент create пишет новые документы в базу BAS для заданных сущностей
- Telegram-токен и ключи LLM-провайдера хранятся в .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 акт выполненных работ за прошлый месяц по конкретному контрагентуMCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
FASTAPI_URLобязательная- Адрес FastAPI-сервиса, который MCP-сервер запрашивает за метаданными и данными
BAS_ENTITY_WHITELIST- Список сущностей BAS через запятую с поддержкой масок, пусто значит все сущности
LLM_PROVIDERобязательная- claude или groq, определяет, какой облачный ключ нужен боту
TELEGRAM_BOT_TOKENобязательная, секрет- Токен Telegram-бота от BotFather, нужен только для запуска бота
Ограничения
README в репозитории пустой, вся информация об установке и переменных окружения собрана по исходному коду и docker-compose.yml. Часть комментариев в коде на украинском языке. Нужны ключи ANTHROPIC_API_KEY или GROQ_API_KEY в зависимости от LLM_PROVIDER, оба зарубежных облачных провайдера. Операция create в MCP-сервере жестко ограничена двумя сущностями в коде, для других нужно менять исходники.
Как отключить. Остановите стек командой docker compose down, для Telegram-бота отдельно остановите сервис bot.
Частые вопросы
Это MCP-сервер именно для российского 1С?
Нет, судя по коду и именам сущностей это BAS: платформа семейства 1С:Предприятие, которую используют на Украине и в СНГ. Название репозитория содержит 1c, но сама база не российская.
Можно ли работать без Claude или Groq?
По исходникам фабрики llm/factory.py поддерживаются только эти два провайдера, оба облачные и зарубежные.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер OData 1С
1C OData MCP Server
Небольшой MCP-сервер на Python, который оборачивает стандартные операции чтения OData 1С:Управление предприятием в три инструмента
MCP-сервер на Python для BAF (украинский аналог 1С:УНФ): метаданные конфигурации, запросы, полнотекстовый поиск по BSL-коду и справка по функциям платформы
Скиллы и бот для данных 1С через OData
1c oData bot
Скиллы OData и поиска по метаданным для AI-агентов плюс Telegram- и email-бот, который отвечает на вопросы о данных 1С обычным языком
MCP-сервер OData 1С с JSON-кэшем
MCP сервер для работы с OData 1C
Python MCP-сервер поверх OData 1С: читает и меняет справочники и документы, сохраняет все данные в JSON-файлы для локального анализа без повторных запросов
MCP-прокси к метаданным 1С (адаптация)
1C_MCP_SERVER_OWN
Python-прокси между MCP-клиентом и HTTP-сервисом 1С: читает метаданные, структуру объектов и предопределенные данные, с опциональным OAuth2
АИ Финансист: MCP-сервер для 1С
mcp_1c (AI Финансист)
Связка MCP-сервера, OData-клиента 1С и локальной языковой модели с чатом на Gradio для вопросов по данным 1С и загруженным PDF
Коротко о 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.