Claude Smalltalk
将Claude Desktop连接到实时Smalltalk编程环境。浏览类、计算表达式、定义方法和运行自主代码审查——所有这些都是针对正在运行的Squeak或Cuis映像。
由John M McIntosh开发,Corporate Smalltalk Consulting有限公司2026
它的作用
Squeak VM提供了14个MCP工具——评估代码、浏览类、读/写方法、导航层次结构和保存映像。Claude Desktop通过以下方式访问它们 smalltalk_task,它将所有Smalltalk交互委托给本地配置的LLM(Ollama免费/本地,或Anthropic/OpenAI/xAI)——没有源代码离开您的机器。
You → Claude Desktop → smalltalk_task → Your LLM → Live Smalltalk Image (TCP)
(MCP server) (Ollama) (Squeak or Cuis)代理将Smalltalk推理与您的聊天模型隔离开来。Claude Desktop触发了这项工作,但实际的Smalltalk编码是由一个单独的模型(可以是本地和免费的)完成的。
快速开始
1.获取Smalltalk虚拟机和映像
吱吱声 (推荐):
- 下载 吱吱6.0 --All-in-One包包括VM和映像
- 跟随 SQUEAK-SETUP.md 将MCP服务器安装到映像中
Cuis Smalltalk:
- 克隆 Cuis Smalltalk Dev
- 跟随 CUIS-SETUP.md 塑造克劳德崔的形象
macOS注意事项: 将VM和映像文件放置在/Applications/或您的主目录。文件在~/Documents/或~/Desktop/可能会被macOS隐私限制(TCC)阻止。看 macOS权限 在......下面
2.创建配置文件并安装
跟随 CLAUDE-README-MCPB.md --它涵盖了创建 smalltalk-mcp.json 配置并安装桌面扩展。
从以下位置复制启动器配置 examples/ 并设置VM路径:
cp examples/smalltalk-mcp-ollama.json smalltalk-mcp.json
# Edit vm.binary and vm.image to match your installVM在首次使用时自动启动,无需手动启动。令牌身份验证是自动处理的。
看 examples/ 适用于Anthropic、OpenAI、xAI和MQTT变体。
3.配置克劳德桌面
编辑 ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):
{
"mcpServers": {
"smalltalkAgent": {
"command": "uv",
"args": ["run", "/path/to/ClaudeSmalltalk/smalltalk_agent_mcp.py"],
"env": {
"SMALLTALK_MCP_CONFIG": "/path/to/smalltalk-mcp.json"
}
}
}
}需要Python 3.10+。依赖关系(httpx)由以下方式自动解决 uv.安装 紫外线 如果您没有它,请按照那里的官方安装说明进行操作(例如通过您的包管理器(如果可用))。如果您选择使用安装脚本,请先查看它,然后按照中描述的任何校验和或签名验证步骤进行操作 uv 文档。
或者,如果您不想使用uv,您可以使用python3如命令所示,但您需要安装httpx你自己(pip install httpx或pip3 install httpx).对于MQTT传输,还有:pip install paho-mqtt.
4.验证其是否有效
打开克劳德桌面并询问:
“列出所有以String开头的Smalltalk类”
可用工具
克劳德桌面(1个工具)
| 工具 | 说明 |
|---|---|
smalltalk_task | 将任何Smalltalk任务委托给本地配置的LLM。源代码不会离开你的机器。 |
VM工具(14,可供代理使用)
| 工具 | 说明 |
|---|---|
smalltalk_evaluate | 执行Smalltalk代码并返回结果 |
smalltalk_browse | 获取类元数据(超类、ivar、方法) |
smalltalk_method_source | 查看方法的源代码 |
smalltalk_define_class | 创建或修改类定义 |
smalltalk_define_method | 添加或更新方法 |
smalltalk_delete_method | 从类中删除方法 |
smalltalk_delete_class | 从系统中删除类 |
smalltalk_list_classes | 列出与前缀匹配的类 |
smalltalk_hierarchy | 获取超一流链条 |
smalltalk_subclasses | 获取直接子类 |
smalltalk_list_categories | 列出所有系统类别 |
smalltalk_classes_in_category | 列出类别中的类 |
smalltalk_save_image | 将当前图像保存到位 |
smalltalk_save_as_new_version | 将图像/更改另存为下一个版本号 |
所有14个工具也可以直接通过 st CLI(openclaw/smalltalk.py).
配置参考
支持的LLM提供商
| 提供程序 | API | 成本 | 配置密钥 |
|---|---|---|---|
| Ollama | /v1/聊天/补全 | 免费(本地) | "provider": "ollama" |
| Anthropic | /v1/消息(httpx) | 付费 | "provider": "anthropic" |
| OpenAI | /v1/聊天/补全 | 付费 | "provider": "openai" |
| xAI | /v1/聊天/补全 | 付费 | "provider": "xai" |
所有供应商使用 httpx (作为依赖项包含)--无需安装其他软件包。
运输选项
| 运输 | 方式 | 用例 |
|---|---|---|
tcp | 令牌认证TCP到Squeak VM | 推荐 --VM是自己的服务器 |
mqtt | MQTT代理到远程映像 | 远程映像,具有MQTT处理程序的Cui |
传输控制协议 是默认值。Squeak虚拟机正在运行 MCPTcpTransport 并在本地端口上监听。代理在首次使用时自动启动VM,生成UUID令牌,并根据请求使用JSON-RPC+令牌身份验证进行连接。
消息队列遥测传输 通过MQTT代理进行连接。用于具有MQTT LLM处理程序的远程映像或Cui。
macOS权限
macOS透明度、同意和控制(TCC)限制了应用程序可以访问的目录。
安全地点 (无需额外权限):
/Applications/--建议用于VM和映像文件~/(主目录根)--用于配置文件
受限地点 (将导致错误):
~/Documents/,~/Desktop/,~/Downloads/
其他集成选项
| 选项 | 架构 | 指南 |
|---|---|---|
| OpenClaw | 电报/Discord↔ 开爪↔ 吱吱叫 | OPENCLAW-SETUP.md |
安全
该扩展仅通过TCP连接到本地Smalltalk映像(仅限localhost)。使用Ollama时,不会将源代码发送到云API。
通过Ollama+TCP传输, Smalltalk源代码不会离开您的机器.
双重安全审计详细信息: 安全.md
文件
| 文件 | 描述 |
|---|---|
Claude.SmalltalkInterface.mcpb | 桌面扩展--双击安装 |
CLAUDE-README-MCPB.md | 与扩展程序捆绑在一起的安装指南 |
smalltalk_agent_mcp.py | MCP服务器(克劳德桌面版标准io JSON-RPC) |
smalltalk_agent.py | 带有工具调用循环的代理,TcpBridge+MqttBridge |
openclaw/smalltalk.py | st CLI——直接TCP访问所有14个工具 |
openclaw/mqtt_bridge.py | 用于Cui/远程映像的MQTT CLI桥 |
smalltalk-mcp-example.json | Starter配置--复制和编辑 |
SKILL.md | 拖动到Claude Desktop以获取Smalltalk最佳实践 |
MCP-Server-Squeak.st | Squeak 6.0的MCP服务器文件(TCP传输) |
MCP-Server.pck.st | Cuis的MCP服务器包 |
examples/ | 所有提供程序和传输的配置示例 |
许可证
MIT许可证——见 许可证
