# ClaudeSmalltalk

MCP-сервер подключает агент к живому образу Squeak или Cuis: смотрит классы, правит методы, сохраняет образ.

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

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

## Установка

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

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

### Codex

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

### Cursor

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

### GitHub Copilot

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

### Gemini CLI

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

## Когда брать
- посмотреть исходник метода, не открывая браузер классов
- добавить метод в класс прямо из окна чата
- пройти по цепочке суперклассов и найти, где объявлено поведение
- сохранить образ Squeak новой версией
- перечислить классы по префиксу перед рефакторингом

## Примеры запросов агенту
- Перечисли через `smalltalk_list_classes` все классы Smalltalk с префиксом `String`.
- Покажи суперклассы и подклассы класса `String`, а потом сохрани образ новой версией.
- Прогони ревью: прочитай методы класса `String` через `smalltalk_method_source` и предложи правки.

## Похожие
- [Serena MCP: the IDE for your agent](https://affpapa.org/nevibecode/mcp/serena-mcp-the-ide-for-your-agent.md) — MCP-сервер · ★ 30677
- [Compiler Explorer](https://affpapa.org/nevibecode/mcp/compiler-explorer.md) — MCP-сервер · ★ 19148
- [Claude Code Explorer MCP](https://affpapa.org/nevibecode/mcp/claude-code-explorer-mcp.md) — MCP-сервер · ★ 6235
- [Tolgee](https://affpapa.org/nevibecode/mcp/tolgee.md) — MCP-сервер · ★ 4139
- [jshookmcp](https://affpapa.org/nevibecode/mcp/jshookmcp.md) — MCP-сервер · ★ 2061
- [pyscn](https://affpapa.org/nevibecode/mcp/pyscn.md) — MCP-сервер · ★ 1096

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