Smalltalk编程环境连接工具

ClaudeSmalltalk是一个将Claude桌面客户端连接到实时Smalltalk编程环境的工具,允许用户在运行的Squeak或Cuis镜像中浏览类、评估表达式、定义方法并运行自主代码审查。

  • by CorporateSmalltalkConsultingLtd
  • StringTemplate
  • 本地部署
  • 18 星标
  • 更新于
在 GitHub 查看 CorporateSmalltalkConsultingLtd/SmalltalkCuisMCP

使用说明

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虚拟机和映像

吱吱声 (推荐):

Cuis Smalltalk:

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 install

VM在首次使用时自动启动,无需手动启动。令牌身份验证是自动处理的。

看 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许可证——见 许可证