ClaudeSmalltalk — MCP-сервер для Claude Code: установка и что делает
MCP-сервер подключает агент к живому образу Squeak или Cuis: смотрит классы, правит методы, сохраняет образ.
claude mcp add claudesmalltalk -- uvx claude-smalltalkЧто делает ClaudeSmalltalk
Сервер держит канал к работающему образу Smalltalk по TCP и отдаёт агенту 14 инструментов: выполнить код, посмотреть класс, прочитать или переписать метод, пройти по цепочке суперклассов, сохранить образ. Сам агент вызывает один инструмент, smalltalk_task, а тот передаёт работу отдельной модели — локальной через Ollama или облачной через Anthropic, OpenAI, xAI.
Настройка идёт через файл smalltalk-mcp.json, путь к нему задаёт переменная SMALLTALK_MCP_CONFIG. Транспорт tcp стоит по умолчанию: VM сама поднимается при первом запросе и проверяет UUID-токен. Для удалённого образа или Cuis с MQTT-обработчиком есть транспорт mqtt.
Нужны Python 3.10+ и uv, он сам подтянет httpx. При запуске через python3 ставьте httpx руками, а для MQTT ещё и paho-mqtt. На macOS образ и VM держите в /Applications/ или в корне домашнего каталога: TCC не даёт приложению читать ~/Documents/ и ~/Desktop/, и запросы к образу падают с ошибкой.
Какие задачи решает
- посмотреть исходник метода, не открывая браузер классов
- добавить метод в класс прямо из окна чата
- пройти по цепочке суперклассов и найти, где объявлено поведение
- сохранить образ Squeak новой версией
- перечислить классы по префиксу перед рефакторингом
Примеры запросов агенту
- Перечисли через
smalltalk_list_classesвсе классы Smalltalk с префиксомString. - Покажи суперклассы и подклассы класса
String, а потом сохрани образ новой версией. - Прогони ревью: прочитай методы класса
Stringчерезsmalltalk_method_sourceи предложи правки.
Как установить ClaudeSmalltalk
Командой платформы
claude mcp add claudesmalltalk -- uvx claude-smalltalkuvx запускает команду с именем пакета; если в README она другая — uvx --from claude-smalltalk <команда>
Командой платформы
codex mcp add claudesmalltalk -- uvx claude-smalltalkuvx запускает команду с именем пакета; если в README она другая — uvx --from claude-smalltalk <команда>
Файл настроек
{
"mcpServers": {
"claudesmalltalk": {
"command": "uvx",
"args": [
"claude-smalltalk"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from claude-smalltalk <команда>
Файл настроек
{
"servers": {
"claudesmalltalk": {
"type": "stdio",
"command": "uvx",
"args": [
"claude-smalltalk"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from claude-smalltalk <команда>
Командой платформы
gemini mcp add claudesmalltalk uvx claude-smalltalkuvx запускает команду с именем пакета; если в README она другая — uvx --from claude-smalltalk <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о ClaudeSmalltalk
Как установить ClaudeSmalltalk в Claude Code?
Одной командой: claude mcp add claudesmalltalk -- uvx claude-smalltalk. Сервер пропишется в конфиг Claude Code, а образ Smalltalk поднимется при первом запросе.
Что делает ClaudeSmalltalk?
Даёт агенту доступ к живому образу Squeak или Cuis: просмотр классов, выполнение кода, правка методов, сохранение образа. Рассуждения о Smalltalk уходят отдельной модели, которую вы выбираете в конфиге.
Нужен ли платный ключ API?
С Ollama нет: провайдер работает локально и бесплатно, код из образа остаётся на машине. Anthropic, OpenAI и xAI — платные провайдеры, ключ прописывается в smalltalk-mcp.json.
