iikona-mcp-proxy

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

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+.

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

Что делает

Прокси решает конкретную задачу: расширение ИИкона поднимает в базе 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: посредник не нужен

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

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

Ограничения

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

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

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-запроса в миллисекундах.

Проверка безопасности

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

Коротко о README

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

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

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

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

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

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

Выбор редакции

Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода

ПлагинСредний рискБез VPN292,5 тыс.Звезды репозитория
Выбор редакции

Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура

СкиллНизкий риск271,4 тыс.Звезды репозитория
Выбор редакции

Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации

CLIСредний рискБез VPN139,3 тыс.Звезды репозитория

Референсные MCP-серверы

Model Context Protocol servers

Официальный

Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything

MCP-серверСредний риск90,6 тыс.Звезды репозитория
Foxx AIiikona-mcp-proxy

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.