Результат: вы направите на этот язык ассистента, который умеет получить URL или запускать инструменты.
Что нужно знать: для первого раздела ничего. Серверу MCP нужен инструментарий, установленный так, как описано в разделе Первая программа.
Начните с одного запроса
Для ассистента, который может получить URL, но не имеет настроенных инструментов, самый доступный общий интерфейс — один самодостаточный файл.
https://topaz.ooo/agents.mdВ нём есть строение файла, формы, граница хоста и профиля продукта, а также особенно важный для модели, уже знающей другие языки, перечень несуществующих форм. Он предостерегает от Vec<T>, async, try, синтаксиса классов и использования null как универсального отсутствия, сохраняя при этом поддерживаемую форму границы данных T | null. Такие явные различия не дают уверенной догадке превратиться в неверный исходный код.
Рядом доступны и другие поверхности для машинного чтения.
https://topaz.ooo/llms.txt служит компактным указателем, а
https://topaz.ooo/llms-full.txt содержит всё англоязычное руководство в
Markdown. Для каждой англоязычной страницы также есть адрес
https://topaz.ooo/docs/<slug>.md. В его frontmatter сохраняются заголовок,
исходный маршрут и охваченные разделы спецификации.
https://topaz.ooo/version.json сообщает, какая версия отвечает.
Если вы настраиваете ассистента для кого-то другого, выдать ему этот один URL и есть вся настройка.
Какую задачу решают инструменты
Загрузка файла приводит ассистента к правильным формам. Она не говорит, компилируется ли на самом деле программа, которую он только что написал.
Ассистент, пишущий на незнакомом языке, делает одно из двух. Либо читает документацию и угадывает, либо пишет, получает точное указание на ошибку и исправляет её. Второй цикл даёт работающий код даже при скудной документации. Первый даёт уверенный текст, который не компилируется. Один только справочник оставляет ассистента в первом цикле. Проверяющий инструмент переводит его во второй.
Четыре опубликованных инструмента
| Инструмент | На какой вопрос отвечает |
|---|---|
topaz_spec | Какова точная форма для этой части языка? |
topaz_examples | Покажи проверенный код для этого понятия. |
topaz_check | Правильно ли то, что я только что написал, и если нет, то где именно? |
topaz_run | Какой результат даёт программа в среде без полномочий? |
topaz_check без изменений возвращает диагностику компилятора, её код и
позицию в исходном тексте. topaz_run сначала выполняет такую же проверку, а
затем для каждого вызова запускает новый рабочий процесс. Оба инструмента
указывают установленный инструментарий и выбранный компилятор, поэтому
ассистент исправляет код по фактическому результату, а не по пересказу.
Граница выполнения
Каждый вызов topaz_run запускает новый скрытый рабочий процесс из того же
установленного файла Топаза и хост без полномочий. У него нет доступа к
файловой системе и сети, обнаружения, callback, компонентов и запасного пути.
Сервер допускает два одновременных запуска без очереди, ограничивает время
пятью секундами и ответ одним MiB, а отменённый процесс завершает и забирает.
Исходный код передаётся через stdin, не журналируется и не сохраняется.
Эта авторская граница входит во все поддерживаемые нативные цели Топаза. Это
не обычный неограниченный topaz run, но и не песочница операционной системы
или жёсткий предел CPU и RSS. Не отправляйте в неё враждебный код.
Дескриптор для машинного чтения
Клиенты и поисковые роботы могут прочитать описание сервера напрямую.
https://topaz.ooo/mcp.jsonТам в структурированном виде перечислены четыре инструмента, их входные данные, встроенная команда, пределы ресурсов и значения проверки установки.
Текущее состояние
Топаз 5.18.1 включает сервер MCP и рабочий процесс в нативный исполняемый файл
topaz. Установка Топаза сразу устанавливает сервер MCP. Отдельного архива,
контрольной суммы и путей к серверу, рабочему процессу или допуску нет.
Установка и подключение
Установите Топаз и настройте следующую локальную команду stdio.
{
"command": "topaz",
"args": ["mcp", "serve"]
}
После подключения клиент должен обнаружить ровно четыре инструмента:
topaz_spec, topaz_examples, topaz_check и topaz_run. Блок
verification в
mcp.json содержит известный раздел справочника,
понятие для поиска примера, исходник без ошибок и чистый запуск со значением
42. Эти значения позволяют проверить реально подключённый сервер, а не
доверять одной лишь конфигурации.
Готовы двигаться дальше, если
Вы готовы двигаться дальше, если умеете найти точную справку, исправить код по диагностике компилятора и выполнить чистую программу во встроенном рабочем процессе без полномочий.
О том, до чего программа может и не может дотянуться, читайте в разделе Границы интеграции. Формы, которые будет искать ассистент, собраны в разделе Краткий обзор синтаксиса.