1C MCP Server с прокси на FastAPI
1C MCP Server
Расширение 1С с HTTP-сервисом MCP плюс Python-прокси на FastAPI, который добавляет транспорт stdio, OAuth2 и Docker-запуск
- 0 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Прокси хранит логин и пароль пользователя 1С в переменных окружения
- HTTP-сервис расширения дает доступ к данным и метаданным опубликованной базы
Установка
- Работает в
- Сервисы
Ручная установка
cd src && python -m venv .venv && . .venv/bin/activate && pip install -r py_server/requirements.txt && python -m py_serverЗапуск Python-прокси локально с зависимостями fastapi, uvicorn, httpx, pydantic и mcp.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Прокси хранит логин и пароль пользователя 1С в переменных окружения
- HTTP-сервис расширения дает доступ к данным и метаданным опубликованной базы
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Проект дает два способа подключить MCP-клиента к 1С: напрямую к опубликованному HTTP-сервису mcp_APIBackend расширения, или через Python-прокси на FastAPI, который добавляет stdio-транспорт для клиентов без HTTP, OAuth2-авторизацию и проброс аутентификации в бэкенд 1С. Расширение поставляется готовым файлом .cfe, прокси запускается локально через venv или в Docker с переменными окружения для адреса, логина и пароля базы 1С. В репозитории есть примеры настроек для Claude Code, Claude Desktop, Cursor и Kilo Code.
Для кого. Для 1С-разработчиков, которым нужен готовый MCP-сервер с гибким транспортом и централизованной авторизацией, а не только прямое HTTP-подключение.
Подходит, если
- Нужен stdio-транспорт для MCP-клиента, который не умеет HTTP напрямую
- Нужна централизованная OAuth2-авторизация перед бэкендом 1С
- Удобнее развернуть через Docker с готовым compose-файлом
Не подходит, если
- Достаточно прямого HTTP-подключения к расширению без прокси
- Не готовы публиковать HTTP-сервис mcp_APIBackend в своей базе
Пример запроса к агенту
Подключись к 1С через MCP-прокси и покажи метаданные справочника НоменклатураMCP
- Транспорт
- http, stdio
- Авторизация
- API-ключ
Переменные окружения
MCP_ONEC_URLобязательная- URL опубликованной базы 1С.
MCP_ONEC_USERNAMEобязательная- Логин пользователя 1С.
MCP_ONEC_PASSWORDобязательная, секрет- Пароль пользователя 1С.
MCP_AUTH_MODE- Режим авторизации прокси: none или oauth2.
Ограничения
Нужно установить расширение в базу и опубликовать HTTP-сервис, README не описывает импорт .cfe пошагово. Пароль пользователя 1С передается прокси в переменных окружения. Проект небольшой, автор один, релизов и звезд нет.
Как отключить. Остановите или удалите Python-прокси, отключите расширение mcp_APIBackend в базе 1С и уберите сервер из настроек MCP-клиента.
Частые вопросы
Обязателен ли Python-прокси?
Нет, README отмечает его как рекомендуемый вариант для stdio-транспорта и централизованной авторизации, но можно подключаться и напрямую к HTTP-сервису расширения.
Как включить OAuth2?
Через переменную MCP_AUTH_MODE со значением oauth2 в конфигурации прокси.
Чем 1C MCP Server с прокси на FastAPI отличается от других MCP для 1С?
Проект дает два способа подключения: напрямую к опубликованному HTTP-сервису mcp_APIBackend расширения 1С или через Python-прокси на FastAPI, который добавляет stdio-транспорт для клиентов без HTTP, OAuth2 и запуск в Docker.
Обязателен ли Python-прокси и как включить OAuth2?
Нет, клиент с поддержкой HTTP подключается к расширению напрямую. Прокси нужен для stdio, OAuth2 и Docker. Параметры OAuth2 задаются в конфиге прокси, см. README. Работает в Claude Code, Claude Desktop и Cursor.
Обсуждение
Вопросов и отзывов пока нет.
MCP-сервер внутри 1С
1c_mcp
Расширение 1С, которое поднимает MCP-сервер прямо в базе: инструменты по метаданным из коробки и свои инструменты на BSL
Расширение 1С с двумя HTTP-эндпоинтами (query и exec) плюс Python MCP-обертка для Claude Code, рассчитанное только на тестовую базу
MCP-прокси к метаданным 1С (адаптация)
1C_MCP_SERVER_OWN
Python-прокси между MCP-клиентом и HTTP-сервисом 1С: читает метаданные, структуру объектов и предопределенные данные, с опциональным OAuth2
Расширение 1С на основе vladimir-kharin/1c_mcp, которое добавляет выполнение произвольного кода встроенного языка прямо в контексте информационной базы
MCP-сервер в клиенте 1С
1C Client MCP Server
Расширение 1С, которое поднимает MCP-сервер прямо внутри клиента 1С:Предприятия и позволяет описывать свои инструменты на BSL
Внешняя обработка 1С с MCP и REST API: запросы, метаданные, журнал регистрации и выполнение кода без изменения конфигурации
Коротко о README
README описывает связку расширения 1С и Python-прокси на FastAPI с зависимостями fastapi, uvicorn, httpx, pydantic и mcp. Даны три способа запуска: установка расширения и публикация HTTP-сервиса, локальный запуск прокси через venv, запуск через Docker с .env.docker.example. Перечислена структура проекта: build с .cfe, src с исходниками, mcp_client_settings с примерами конфигураций клиентов.