ClaudeSmalltalk

本地服务

github.com/CorporateSmalltalkConsultingLtd开发工具1815 周前更新

代码仓库

关于 ClaudeSmalltalk

ClaudeSmalltalk 将 Claude Desktop 连接到运行中的 Squeak 或 Cuis 镜像，用于 Smalltalk 开发和代码审查。MCP 服务将任务交给本地配置的 LLM，由 Agent 调用镜像操作。

主要功能

01执行 Smalltalk 代码
02浏览类和方法源码
03定义或删除类与方法
04查看类层级关系
05保存当前镜像或新版本

适用场景

01检查运行中镜像的类
02修改方法或类定义
03执行 Smalltalk 代码审查任务
04保存开发镜像版本

MCP 相关

MCP 服务向 Claude Desktop 提供 `smalltalk_task`，将工作委托给配置的本地 LLM。Agent 可通过 TCP 或 MQTT 使用 14 个 VM 工具。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "johnmci-claudesmalltalk": {
      "command": "uvx",
      "args": [
        "claude-smalltalk"
      ]
    }
  }
}

启动命令uvx claude-smalltalk

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

pypiclaude-smalltalk1.2.1stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

ClaudeSmalltalk

将 Claude Desktop 连接到实时 Smalltalk 编程环境。浏览类、计算表达式、定义方法并运行自主代码审查——所有操作都针对正在运行的 Squeak 或 Cuis 映像。

由 John M McIntosh（Corporate Smalltalk Consulting Ltd.）开发，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)

该 Agent 将 Smalltalk 推理与聊天模型隔离。Claude Desktop 负责触发任务，但实际执行 Smalltalk 编码的是另一个模型（可以是本地且免费的模型）。

快速开始

1. 获取 Smalltalk VM 和映像

Squeak（推荐）：

下载 Squeak 6.0——All-in-One 软件包包含 VM 和映像
按照 SQUEAK-SETUP.md 的说明将 MCP 服务安装到映像中

Cuis Smalltalk：

克隆 Cuis-Smalltalk-Dev
按照 CUIS-SETUP.md 的说明构建 ClaudeCuis 映像

macOS 注意事项： 将 VM 和映像文件放在 /Applications/ 或你的主目录中。由于 macOS 隐私限制（TCC），位于 ~/Documents/ 或 ~/Desktop/ 中的文件可能会被阻止。请参阅下文的 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. 配置 Claude Desktop

编辑 ~/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+。uv 会自动解析依赖项（httpx）。如果尚未安装 uv，请按照其官方安装说明进行安装（例如，在适用的情况下通过软件包管理器安装）。如果选择使用安装脚本，请先检查脚本，并按照 uv 文档中的说明验证校验和或签名。

或者，如果你不想使用 uv，也可以将 python3 用作命令——但需要自行安装 httpx（pip install httpx 或 pip3 install httpx）。使用 MQTT 传输时，还需运行：pip install paho-mqtt。

4. 验证是否正常运行

打开 Claude Desktop 并询问：

“列出所有以 String 开头的 Smalltalk 类”

可用工具

Claude Desktop（1 个工具）

工具	描述
`smalltalk_task`	将任意 Smalltalk 任务交由本地配置的 LLM 处理。源代码不会离开你的计算机。

VM 工具（14 个，Agent 可用）

工具	描述
`smalltalk_evaluate`	执行 Smalltalk 代码并返回结果
`smalltalk_browse`	获取类元数据（超类、实例变量、方法）
`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）直接使用。

配置参考

支持的大模型提供商

提供商	API	费用	配置键
Ollama	/v1/chat/completions	免费（本地）	`"provider": "ollama"`
Anthropic	/v1/messages (httpx)	付费	`"provider": "anthropic"`
OpenAI	/v1/chat/completions	付费	`"provider": "openai"`
xAI	/v1/chat/completions	付费	`"provider": "xai"`

所有提供商均使用 httpx（作为依赖项包含在内），无需安装其他软件包。

传输选项

传输方式	工作方式	使用场景
`tcp`	通过令牌验证的 TCP 连接到 Squeak VM	推荐 — VM 本身就是服务端
`mqtt`	通过 MQTT 代理连接到远程映像	远程映像、带 MQTT 处理器的 Cuis

tcp 是默认选项。Squeak VM 运行 MCPTcpTransport 并监听本地端口。Agent 会在首次使用时自动启动 VM，生成 UUID 令牌，并在每次请求时通过 JSON-RPC + 令牌验证建立连接。

mqtt 通过 MQTT 代理连接。适用于远程映像，或带 MQTT LLM 处理器的 Cuis。

macOS 权限

macOS 的透明度、同意与控制（TCC）机制会限制应用程序可访问的目录。

安全位置（无需额外权限）：

/Applications/ — 推荐用于 VM 和映像文件
~/（主目录根目录）— 可用于配置文件

受限位置（会导致错误）：

~/Documents/、~/Desktop/、~/Downloads/

其他集成选项

选项	架构	指南
OpenClaw	Telegram/Discord ↔ OpenClaw ↔ Squeak	OPENCLAW-SETUP.md

安全性

此扩展仅通过 TCP 连接到本地 Smalltalk 映像（仅限 localhost）。使用 Ollama 时，不会向云端 API 发送源代码。

使用 Ollama + TCP 传输时，Smalltalk 源代码不会离开你的设备。

双重安全审计详情：SECURITY.md

文件

文件	描述
`Claude.SmalltalkInterface.mcpb`	桌面扩展 — 双击安装
`CLAUDE-README-MCPB.md`	随扩展附带的设置指南
`smalltalk_agent_mcp.py`	MCP 服务（面向 Claude Desktop 的 stdio JSON-RPC）
`smalltalk_agent.py`	带工具调用循环的 Agent，包含 TcpBridge + MqttBridge
`openclaw/smalltalk.py`	`st` CLI — 通过 TCP 直接访问全部 14 个工具
`openclaw/mqtt_bridge.py`	用于 Cuis/远程映像的 MQTT CLI 桥接程序
`smalltalk-mcp-example.json`	入门配置 — 复制并编辑
`SKILL.md`	拖入 Claude Desktop，了解 Smalltalk 最佳实践
`MCP-Server-Squeak.st`	适用于 Squeak 6.0 的 MCP 服务 fileIn（TCP 传输）
`MCP-Server.pck.st`	适用于 Cuis 的 MCP 服务包
`examples/`	适用于所有提供商和传输方式的配置示例

许可证

MIT License — 参见 LICENSE

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。

ClaudeSmalltalk

关于 ClaudeSmalltalk

主要功能

适用场景

MCP 相关

配置

工具

详细介绍

ClaudeSmalltalk

功能

快速开始

1. 获取 Smalltalk VM 和映像

2. 创建配置文件并安装

3. 配置 Claude Desktop

4. 验证是否正常运行

可用工具

Claude Desktop（1 个工具）

VM 工具（14 个，Agent 可用）

配置参考

支持的大模型提供商

传输选项

macOS 权限

其他集成选项

安全性

文件

许可证

评论

第一次接触 MCP？

MCP（Model Context Protocol）是什么？

MCP 服务和客户端有什么区别？

本地服务与远程服务怎么选？

如何在 Claude、Cursor 等客户端中安装服务？

收录的项目经过审核吗？“认证”标识代表什么？

我维护的项目已被收录，怎样认领？