# Sounio Compiler

Локальный MCP-сервер компилятора Sounio для проверки типов и сборки файлов .sio прямо через агента. Позволяет закрывать цикл отладки кода без выхода из консоли.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 12
- Автор: Sounio-lang
- Лицензия: Apache-2.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/Sounio-lang/sounio/tree/HEAD/tools/mcp
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/mcp/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` сервер также отфильтрует переменные окружения, если в них передаются пароли или токены доступа.

## Требования
- Нужно: Python и uv (команды через uvx)

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add sounio-mcp-server -- uvx sounio-mcp-server
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from sounio-mcp-server <команда>

### Codex

**Командой платформы**
```bash
codex mcp add mcp -- uvx sounio-mcp-server
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from sounio-mcp-server <команда>

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp": {
            "command": "uvx",
            "args": [
                "sounio-mcp-server"
            ]
        }
    }
}
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from sounio-mcp-server <команда>

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "sounio-mcp-server"
            ]
        }
    }
}
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from sounio-mcp-server <команда>

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add mcp uvx sounio-mcp-server
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from sounio-mcp-server <команда>

## Когда брать
- проверить типы в файлах `.sio` до компиляции
- собрать бинарный файл под нужную платформу через `souc`
- запустить готовую программу с контролем таймаута
- прогнать тестовые сценарии с директивами `//@ run-pass` и `//@ compile-fail`
- получить официальное описание ошибки компилятора по её коду

## Примеры запросов агенту
- Проверь ошибки типов в файле `examples/hello.sio`.
- Скомпилируй `tests/fixtures/broken_dose.sio` в ELF и покажи вывод сборщика.
- Объясни ошибку `E070`, используя справочный ресурс компилятора Sounio.

## Похожие
- [zig-compiler](https://affpapa.org/nevibecode/skills/zig-compiler.md) — скилл · 450 установок
- [Compiler Explorer](https://affpapa.org/nevibecode/mcp/compiler-explorer.md) — MCP-сервер · ★ 19155
- [check-compiler-errors](https://affpapa.org/nevibecode/skills/check-compiler-errors.md) — скилл · 2300 установок
- [reference-compiler-cli](https://affpapa.org/nevibecode/skills/reference-compiler-cli.md) — скилл · 909 установок
- [build-fix](https://affpapa.org/nevibecode/skills/build-fix.md) — скилл · 2800 установок
- [Solidity Compiler IDE](https://affpapa.org/nevibecode/mcp/solidity-compiler-ide.md) — MCP-сервер · ★ 28

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md