mumez/pharo-smalltalk-interop-mcp-server

> **⚠️ This project has moved.** Starting with v4.0.0, development has moved to smalltalk-interop-mcp-server, which adds support for Squeak's SIS server in addition to Pharo. Please use the new repository for the latest features and updates; this repository is kept for historical reference only.
A local MCP server to communicate local Pharo Smalltalk image.
It supports:
- Code Evaluation: Execute Smalltalk expressions and return results
- Code Introspection: Retrieve source code, comments, and metadata for classes and methods
- Search & Discovery: Find classes, traits, methods, references, and implementors
- Package Management: Export and import packages in Tonel format
- Project Installation: Install projects using Metacello
- Test Execution: Run test suites at package or class level
- UI Debugging: Capture screenshots and inspect UI structure for World morphs, Spec presenters, and Roassal visualizations
- Server Configuration: Retrieve and modify server settings dynamically
Prerequisites
- Python 3.10 or later
- uv package manager
- Pharo with PharoSmalltalkInteropServer installed
Installation
Quick Start (using uvx)
The easiest way to run the server without cloning the repository:
Development Installation
To set up for development:
1. Clone the repository:
2. Install dependencies using uv:
Usage
Running the MCP Server
**Using uvx (no installation required):**
**Using uv (after cloning the repository):**
Environment Variables
You can configure the server using environment variables:
- **PHARO_SIS_PORT**: Port number for PharoSmalltalkInteropServer (default: 8086)
Examples:
**Using uvx:**
**Using uv:**
Cursor MCP settings
**Using uvx (recommended):**
**Using uv (after cloning):**
Note: The env section is optional and can be used to set environment variables for the MCP server.
Claude Code Configuration
**Using uvx (recommended):**
**Using uv (after cloning):**
MCP Tools Available
This server provides 22 MCP tools that map to all PharoSmalltalkInteropServer APIs:
Code Evaluation
- **eval**: Execute Smalltalk expressions and return results
Code Introspection
- **get_class_source**: Retrieve source code of a class
- **get_method_source**: Retrieve source code of a specific method
- **get_class_comment**: Retrieve comment/documentation of a class
Search & Discovery
- **search_classes_like**: Find classes matching a pattern
- **search_methods_like**: Find methods matching a pattern
- **search_traits_like**: Find traits matching a pattern
- **search_implementors**: Find all implementors of a method selector
- **search_references**: Find all references to a method selector
- **search_references_to_class**: Find all references to a class
Package Management
- **list_packages**: List all packages in the image
- **list_classes**: List classes in a specific package
- **list_extended_classes**: List extended classes in a package
- **list_methods**: List methods in a package
- **export_package**: Export a package in Tonel format
- **import_package**: Import a package from specified path
Project Installation
- **install_project**: Install a project using Metacello with optional load groups
Test Execution
- **run_package_test**: Run test suites for a package
- **run_class_test**: Run test suites for a specific class
UI Debugging
- **read_screen**: UI screen reader for debugging Pharo interfaces with screenshot and structure extraction