Sounio Compiler — MCP-сервер для Claude Code: обзор и запуск
Локальный MCP-сервер компилятора Sounio для проверки типов и сборки файлов .sio прямо через агента. Позволяет закрывать цикл отладки кода без выхода из консоли.
claude mcp add sounio-mcp-server -- uvx sounio-mcp-serverЧто делает Sounio Compiler
Сервер связывает ИИ-агента с компилятором souc через стандартный ввод-вывод stdio. В нём нет сетевого транспорта HTTP. Доступны четыре инструмента: sounio_check проверяет типы и возвращает структурированные ошибки, sounio_compile собирает файл в локальный артефакт (например, ELF или WebAssembly), sounio_run запускает полученную программу, а sounio_test прогоняет тесты с директивами вроде //@ run-pass.
Помимо инструментов сервер открывает ресурсы с документацией стандартной библиотеки sounio://stdlib/ и каталогом ошибок компилятора sounio://errors/. Агент видит точные номера строк и пояснения к сбоям. Цикл отладки получается коротким: модель правит код, вызывает проверку и сразу исправляет новые замечания.
Сервер отклоняет любые пути к исходникам за пределами каталога /workspace/sounio. Для поиска компилятора используется локальный скрипт scripts/lib/resolve_souc.sh, поэтому компилятор должен быть собран в репозитории заранее. При вызове sounio_run сервер также отфильтрует переменные окружения, если в них передаются пароли или токены доступа.
Какие задачи решает
- проверить типы в файлах
.sioдо компиляции - собрать бинарный файл под нужную платформу через
souc - запустить готовую программу с контролем таймаута
- прогнать тестовые сценарии с директивами
//@ run-passи//@ compile-fail - получить официальное описание ошибки компилятора по её коду
Примеры запросов агенту
- Проверь ошибки типов в файле
examples/hello.sio. - Скомпилируй
tests/fixtures/broken_dose.sioв ELF и покажи вывод сборщика. - Объясни ошибку
E070, используя справочный ресурс компилятора Sounio.
Как установить Sounio Compiler
Командой платформы
claude mcp add sounio-mcp-server -- uvx sounio-mcp-serveruvx запускает команду с именем пакета; если в README она другая — uvx --from sounio-mcp-server <команда>
Командой платформы
codex mcp add mcp -- uvx sounio-mcp-serveruvx запускает команду с именем пакета; если в README она другая — uvx --from sounio-mcp-server <команда>
Файл настроек
{
"mcpServers": {
"mcp": {
"command": "uvx",
"args": [
"sounio-mcp-server"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from sounio-mcp-server <команда>
Файл настроек
{
"servers": {
"mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"sounio-mcp-server"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from sounio-mcp-server <команда>
Командой платформы
gemini mcp add mcp uvx sounio-mcp-serveruvx запускает команду с именем пакета; если в README она другая — uvx --from sounio-mcp-server <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Sounio Compiler
Как установить Sounio Compiler в Claude Code?
Выполните команду claude mcp add sounio-mcp-server -- uvx sounio-mcp-server. Сервер подключится локально через транспорт stdio.
Что делает MCP-сервер Sounio Compiler?
Он даёт агенту инструменты для проверки синтаксиса и типов в коде на Sounio, компиляции бинарников, запуска тестов и чтения встроенной документации.
С какими каталогами может работать сервер?
Сервер принимает пути к файлам только внутри рабочей директории /workspace/sounio. Запросы к файлам за пределами этого пути компилятор отклоняет.
