iikona-mcp-proxy
Тонкий stdio-мост для расширения ИИкона: переводит MCP по stdio в HTTP-вызовы к сервису 1С, дает базу 1С Claude Desktop и Cursor
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- Инструмент execute_query может выполнять запросы к базе 1С через сервис расширения
- Пароль HTTP Basic хранится в конфигурации MCP-клиента
Установка
Ручная установка
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, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything