ClaudeSmalltalk

ClaudeSmalltalk

Claude Desktop をライブの Smalltalk プログラミング環境に接続します。実行中の Squeak または Cuis イメージに対して、クラスの閲覧、式の評価、メソッドの定義、自律的なコードレビューの実行を行えます。

John M McIntosh、Corporate Smalltalk Consulting Ltd. により開発。2026 年

概要

Squeak VM は、コードの評価、クラスの閲覧、メソッドの読み取り／書き込み、階層の移動、イメージの保存を行う 14 個の MCP ツールを提供します。Claude Desktop は smalltalk_task を介してこれらにアクセスします。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 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/ またはホームディレクトリに配置してください。~/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 が自動起動するため、手動で起動する必要はありません。トークン認証も自動的に処理されます。

Anthropic、OpenAI、xAI、MQTT 向けの設定例については、examples/ を参照してください。

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 以降が必要です。依存関係（httpx）は uv によって自動的に解決されます。uv がインストールされていない場合は、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 個、エージェントが利用可能）

ツール	説明
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）からも直接利用できます。

設定リファレンス

対応する LLM プロバイダー

プロバイダー	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	Squeak VM へのトークン認証付き TCP 接続	推奨 — VM 自体がサーバーとして動作します
mqtt	MQTT ブローカー経由でリモートイメージに接続	リモートイメージ、MQTT ハンドラーを備えた Cuis

デフォルトは tcp です。Squeak VM は MCPTcpTransport を実行し、ローカルポートで待ち受けます。エージェントは初回使用時に 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	ツール呼び出しループを備えたエージェント、TcpBridge + MqttBridge
openclaw/smalltalk.py	st CLI — 14 個すべてのツールへの直接 TCP アクセス
openclaw/mqtt_bridge.py	Cuis／リモートイメージ用 MQTT CLI ブリッジ
smalltalk-mcp-example.json	初期設定用の設定 — コピーして編集してください
SKILL.md	Smalltalk のベストプラクティスを Claude Desktop にドラッグして読み込ませます
MCP-Server-Squeak.st	Squeak 6.0 用の MCP サーバー fileIn（TCP トランスポート）
MCP-Server.pck.st	Cuis 用の MCP サーバーパッケージ
examples/	すべてのプロバイダーとトランスポートの設定例

ライセンス

MIT ライセンス — LICENSE を参照してください