SkillFoxx
Telegram

iikona-mcp-proxy

Тонкий stdio-мост для расширения ИИкона: переводит MCP по stdio в HTTP-вызовы к сервису 1С, дает базу 1С Claude Desktop и Cursor

  • 0 ★ репозитория
  • Последний коммит
  • MIT
MCP-сервер

Расширенный доступ

Почему такой уровень

  • Инструмент execute_query может выполнять запросы к базе 1С через сервис расширения
  • Пароль HTTP Basic хранится в конфигурации MCP-клиента
Все причины и проверки
Российский стек

andromanpro/1c-ai-connector-mcp-proxyАвтор:Роман Андриянов

Установка

Ручная установка

git clone https://github.com/andromanpro/1c-ai-connector-mcp-proxy.git
cd 1c-ai-connector-mcp-proxy
npm install
npm test

Установка из исходников, требует Node.js 18+.

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Инструмент execute_query может выполнять запросы к базе 1С через сервис расширения
  • Пароль HTTP Basic хранится в конфигурации MCP-клиента

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Прокси решает конкретную задачу: расширение ИИкона поднимает в базе 1С HTTPService с runtime-MCP сервисом по адресу /iikona-mcp/rpc, но большинство MCP-клиентов вроде Claude Desktop и Cursor умеют говорить только по stdio. iikona-mcp-proxy это тонкий Node.js посредник, который принимает стандартный MCP-хендшейк по stdio и пересылает вызовы HTTP-запросами с Basic-авторизацией в 1С. После подключения в чате становятся доступны пять инструментов: ping, get_configuration_info, get_metadata_tree, get_object_structure и execute_query. Для отладки без MCP-клиента есть отдельный CLI test-call.js, который дергает те же методы напрямую.

Для кого. Для пользователей расширения ИИкона в 1С, которым нужно подключить его runtime-MCP сервис к Claude Desktop, Cursor или другому stdio-клиенту.

Подходит, если

  • В базе 1С установлено расширение ИИкона (1c-ai-connector) с включенным HTTPService
  • MCP-клиент поддерживает только stdio-транспорт, а сервис 1С доступен только по HTTP
  • Нужна отладка вызовов к сервису 1С без запуска полноценного MCP-клиента

Не подходит, если

  • Расширение ИИкона (1c-ai-connector) не установлено: прокси без него бесполезен
  • MCP-клиент умеет напрямую подключаться по HTTP: посредник не нужен

Пример запроса к агенту

Покажи дерево метаданных базы через ИИкону

MCP

Транспорт
stdio
Авторизация
API-ключ

Переменные окружения

IIKONA_MCP_URL обязательная
URL JSON-RPC эндпоинта HTTPService в 1С.
IIKONA_MCP_USER обязательная
Имя пользователя для HTTP Basic-авторизации.
IIKONA_MCP_PASS обязательная, секрет
Пароль для HTTP Basic-авторизации.
IIKONA_MCP_TIMEOUT_MS
Таймаут HTTP-запроса в миллисекундах.

Ограничения

Работает только вместе с отдельным расширением 1c-ai-connector, которое не входит в этот репозиторий. Публикация в npm на момент README не завершена, пакет ожидается доступным через npx, а пока нужна установка из исходников. Простая проверка через echo в stdin не работает: клиент должен провести полноценный MCP-хендшейк.

Как отключить. Удалите запись iikona из конфигурации MCP клиента, например из claude_desktop_config.json.

Частые вопросы

Нужен ли этот прокси, если сервис 1С уже отдает HTTP?

Да, если ваш MCP-клиент говорит только по stdio, как Claude Desktop и Cursor, прокси нужен как переводчик между stdio и HTTP.

Как проверить работу сервиса 1С без MCP-клиента?

Утилитой node tools/test-call.js с методами вроде ping или tools/call get_configuration_info, она использует те же переменные окружения.

Обсуждение

Вопросов и отзывов пока нет.

1С:Предприятие — все инструменты
Российский стек

Stdio-прокси между Claude Code и MCP-сервером client_mcp внутри 1С, который сам переподключается после рестарта 1С без ручной команды /mcp

MCP-серверРасширенный доступ
Российский стек

Python-прокси между MCP-клиентом и HTTP-сервисом 1С: читает метаданные, структуру объектов и предопределенные данные, с опциональным OAuth2

MCP-серверРасширенный доступ9
Российский стек

MCP-прокси на Go, который динамически превращает HTTP-сервис любой учетной системы, включая 1С, в набор MCP-инструментов без написания сервера вручную

MCP-серверРасширенный доступ
Российский стек

Docker-шлюз с одним адресом вместо нескольких MCP-подключений: данные 1С, навигация по BSL, поиск по ИТС через 1С:Напарник и веб-дашборд

MCP-серверШирокий доступ5
Российский стек

Docker-шлюз на 40 с лишним MCP-инструментов для 1С с одним адресом, веб-дашбордом настроек и набором скиллов 1С для Claude Code

MCP-серверШирокий доступ

ИИкона

ИИкона (1c-ai-connector)

Российский стек

Расширение 1С с коннектором к LLM, агентским циклом, RAG, мониторингом ошибок и MCP-сервером, который открывает базу внешним агентам

MCP-серверШирокий доступ108

Коротко о README

README описывает прокси как посредника stdio-HTTP для runtime-MCP сервиса расширения ИИкона, дает установку через npm install и планируемый способ через npx, таблицу переменных окружения (URL, логин, пароль, таймаут), конфигурацию для Claude Desktop и список пяти доступных инструментов. Отдельно объяснено, почему простая проверка echo в stdin не работает, и дан внутренний CLI для smoke-теста. Показана архитектурная схема потока и перечислены связанные репозитории: само расширение, YAxUnit-тесты и руководство пользователя. Лицензия MIT.

Бейдж для README

Сообщить о проблеме