corporatesmalltalkconsultingltd avatar

Claudesmalltalk

corporatesmalltalkconsultingltd/claudesmalltalk

Connects Claude Desktop to a running Squeak or Cuis Smalltalk image over TCP or MQTT. You get 14 tools: evaluate expressions, browse classes, read and write methods, navigate hierarchies, save the image. The architecture is clever: Claude Desktop calls a single smalltalk_task tool, which delegates to your choice of LLM (Ollama, Anthropic, OpenAI, xAI) to do the actual Smalltalk work. That means the Smalltalk reasoning happens in a separate model, and with Ollama your source code never leaves your machine. Reach for this if you're doing live Smalltalk development and want LLM assistance without manually copying code back and forth or exposing your work to cloud APIs.

GitHub stars
18
tools
15
transport
STDIO
last updated
Jan 24, 2026

Tools

15 tools

Public tool metadata for what this MCP can expose to an agent.

smalltalk_taskDelegate any Smalltalk task to a locally-configured LLM. No source code leaves your machine.

Delegate any Smalltalk task to a locally-configured LLM. No source code leaves your machine.

No parameter schema in public metadata yet.

smalltalk_evaluateExecute Smalltalk code and return result

Execute Smalltalk code and return result

No parameter schema in public metadata yet.

smalltalk_browseGet class metadata (superclass, ivars, methods)

Get class metadata (superclass, ivars, methods)

No parameter schema in public metadata yet.

smalltalk_method_sourceView source code of a method

View source code of a method

No parameter schema in public metadata yet.

smalltalk_define_classCreate or modify a class definition

Create or modify a class definition

No parameter schema in public metadata yet.

smalltalk_define_methodAdd or update a method

Add or update a method

No parameter schema in public metadata yet.

smalltalk_delete_methodRemove a method from a class

Remove a method from a class

No parameter schema in public metadata yet.

smalltalk_delete_classRemove a class from the system

Remove a class from the system

No parameter schema in public metadata yet.

smalltalk_list_classesList classes matching a prefix

List classes matching a prefix

No parameter schema in public metadata yet.

smalltalk_hierarchyGet superclass chain

Get superclass chain

No parameter schema in public metadata yet.

smalltalk_subclassesGet immediate subclasses

Get immediate subclasses

No parameter schema in public metadata yet.

smalltalk_list_categoriesList all system categories

List all system categories

No parameter schema in public metadata yet.

smalltalk_classes_in_categoryList classes in a category

List classes in a category

No parameter schema in public metadata yet.

smalltalk_save_imageSave the current image in place

Save the current image in place

No parameter schema in public metadata yet.

smalltalk_save_as_new_versionSave image/changes as next version number

Save image/changes as next version number

No parameter schema in public metadata yet.

Sponsors

Readme

ClaudeSmalltalk

Connect Claude Desktop to a live Smalltalk programming environment. Browse classes, evaluate expressions, define methods, and run autonomous code review — all against a running Squeak or Cuis image.

Developed by John M McIntosh, Corporate Smalltalk Consulting Ltd. 2026

What It Does

The Squeak VM provides 14 MCP tools — evaluate code, browse classes, read/write methods, navigate hierarchies, and save the image. Claude Desktop accesses them via smalltalk_task, which delegates all Smalltalk interaction to a locally-configured LLM (Ollama for free/local, or Anthropic/OpenAI/xAI) — no source code leaves your machine.

You → Claude Desktop → smalltalk_task → Your LLM → Live Smalltalk Image (TCP)
                        (MCP server)     (Ollama)    (Squeak or Cuis)

The agent isolates Smalltalk reasoning from your chat model. Claude Desktop triggers the work, but a separate model (which can be local and free) does the actual Smalltalk coding.

Quick Start

1. Get a Smalltalk VM and Image


View the full README on GitHub

Details

Repository
github.com/corporatesmalltalkconsultingltd/claudesmalltalk
Package
claude-smalltalk
Transport
STDIO
Registry
MCP registry, active