1C MCP Server с прокси на FastAPI
1C MCP Server
Расширение 1С с HTTP-сервисом MCP плюс Python-прокси на FastAPI, который добавляет транспорт stdio, OAuth2 и Docker-запуск
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- Прокси хранит логин и пароль пользователя 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.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Проект дает два способа подключить 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-прокси и покажи метаданные справочника НоменклатураОграничения
Нужно установить расширение в базу и опубликовать HTTP-сервис, README не описывает импорт .cfe пошагово. Пароль пользователя 1С передается прокси в переменных окружения. Проект небольшой, автор один, релизов и звезд нет.
Как отключить. Остановите или удалите Python-прокси, отключите расширение 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. |
Проверка безопасности
- Прокси хранит логин и пароль пользователя 1С в переменных окружения
- HTTP-сервис расширения дает доступ к данным и метаданным опубликованной базы
Коротко о README
README описывает связку расширения 1С и Python-прокси на FastAPI с зависимостями fastapi, uvicorn, httpx, pydantic и mcp. Даны три способа запуска: установка расширения и публикация HTTP-сервиса, локальный запуск прокси через venv, запуск через Docker с .env.docker.example. Перечислена структура проекта: build с .cfe, src с исходниками, mcp_client_settings с примерами конфигураций клиентов.
Частые вопросы
Обязателен ли Python-прокси?
Нет, README отмечает его как рекомендуемый вариант для stdio-транспорта и централизованной авторизации, но можно подключаться и напрямую к HTTP-сервису расширения.
Как включить OAuth2?
Через переменную MCP_AUTH_MODE со значением oauth2 в конфигурации прокси.
Похожие
Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything