smalltalk-validator-mcp-server

mumez/smalltalk-validator-mcp-server

3.3

If you are the rightful owner of smalltalk-validator-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

A simple MCP server for validating Tonel formatted Smalltalk source code using tonel-smalltalk-parser.

Tools

  1. validate_tonel_smalltalk_from_file

    Validate Tonel formatted Smalltalk source code from a file.

  2. validate_tonel_smalltalk

    Validate Tonel formatted Smalltalk source code from content string.

  3. validate_smalltalk_method_body

    Validate a Smalltalk method body for syntax correctness.

smalltalk-validator-mcp-server

A simple MCP server for validating Tonel formatted Smalltalk source code using tonel-smalltalk-parser.

  • The purpose is that we would like to validate AI-generated tonel files and Smalltalk method definitions before loading them into a real Smalltalk environment.

Tools

validate_tonel_smalltalk_from_file(file_path, options)

  • Validate Tonel formatted Smalltalk source code from a file

validate_tonel_smalltalk(file_content, options)

  • Validate Tonel formatted Smalltalk source code from content string

validate_smalltalk_method_body(method_body_content)

  • Validate a Smalltalk method body for syntax correctness

options

without-method-body: true
    if true, it only validates tonel structure only (mainly for testing)

Installation

git clone https://github.com/your-username/smalltalk-validator-mcp-server.git
cd smalltalk-validator-mcp-server
uv sync

Usage

Running the MCP Server

uv run smalltalk-validator-mcp-server

Configuration Examples

Cursor Configuration

Add to your .cursor/settings.json:

{
  "mcpServers": {
    "smalltalk-validator": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/smalltalk-validator-mcp-server",
        "run",
        "smalltalk-validator-mcp-server"
      ]
    }
  }
}
Claude Code Configuration

Add to your Claude Code settings:

claude mcp add smalltalk-validator -- uv --directory /path/to/smalltalk-validator-mcp-server run smalltalk-validator-mcp-server

Tool Usage Examples

Validate Tonel file from filesystem
# Validate a complete Tonel file with method bodies
validate_tonel_smalltalk_from_file("/path/to/MyClass.st")

# Validate only Tonel structure (without method body validation)
validate_tonel_smalltalk_from_file("/path/to/MyClass.st", {"without-method-body": true})
Validate Tonel content directly
tonel_content = """
Class {
    #name : #MyClass,
    #superclass : #Object,
    #category : #'My-Package'
}

{ #category : #accessing }
MyClass >> getValue [
    ^ 42
]
"""

validate_tonel_smalltalk(tonel_content)
Validate Smalltalk method body
method_body = "^ self name asUppercase"
validate_smalltalk_method_body(method_body)

Development

# Install dependencies
uv sync

# Run tests
uv run pytest

# Lint and format
uv run ruff check
uv run ruff format

# Install pre-commit hooks
uv run pre-commit install