Smalltalk Validator Mcp Server

by mumez

148 downloads

Not rated

GitHub

Other

About

MCP server for validating and linting Tonel formatted Smalltalk source code using tree-sitter-tonel-smalltalk.

Details

Author: mumez
Downloads: 148
Categories: Other

- Validate Tonel files from file path or content string.
- Validate Smalltalk method bodies for syntax correctness.
- Lint Tonel files for best practices and style issues.
- Option to skip method body validation with without-method-body.
- Returns structured results with issues, counts, and severities.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Smalltalk Validator Mcp Server

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "smalltalk validator mcp server": {
            "smalltalk-validator": {
                "command": "uvx",
                "args": [
                    "--from",
                    "git+https://github.com/mumez/smalltalk-validator-mcp-server.git@main",
                    "smalltalk-validator-mcp-server"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "smalltalk validator mcp server": {
            "smalltalk-validator": {
                "command": "uvx",
                "args": [
                    "--from",
                    "git+https://github.com/mumez/smalltalk-validator-mcp-server.git@main",
                    "smalltalk-validator-mcp-server"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "smalltalk validator mcp server": {
            "smalltalk-validator": {
                "command": "uvx",
                "args": [
                    "--from",
                    "git+https://github.com/mumez/smalltalk-validator-mcp-server.git@main",
                    "smalltalk-validator-mcp-server"
                ]
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "smalltalk validator mcp server": {
            "smalltalk-validator": {
                "command": "uvx",
                "args": [
                    "--from",
                    "git+https://github.com/mumez/smalltalk-validator-mcp-server.git@main",
                    "smalltalk-validator-mcp-server"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "smalltalk validator mcp server": {
            "smalltalk-validator": {
                "command": "uvx",
                "args": [
                    "--from",
                    "git+https://github.com/mumez/smalltalk-validator-mcp-server.git@main",
                    "smalltalk-validator-mcp-server"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "smalltalk validator mcp server": {
            "smalltalk-validator": {
                "command": "uvx",
                "args": [
                    "--from",
                    "git+https://github.com/mumez/smalltalk-validator-mcp-server.git@main",
                    "smalltalk-validator-mcp-server"
                ]
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "smalltalk validator mcp server": {
            "smalltalk-validator": {
                "command": "uvx",
                "args": [
                    "--from",
                    "git+https://github.com/mumez/smalltalk-validator-mcp-server.git@main",
                    "smalltalk-validator-mcp-server"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "smalltalk validator mcp server": {
            "smalltalk-validator": {
                "command": "uvx",
                "args": [
                    "--from",
                    "git+https://github.com/mumez/smalltalk-validator-mcp-server.git@main",
                    "smalltalk-validator-mcp-server"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "smalltalk validator mcp server": {
            "smalltalk-validator": {
                "command": "uvx",
                "args": [
                    "--from",
                    "git+https://github.com/mumez/smalltalk-validator-mcp-server.git@main",
                    "smalltalk-validator-mcp-server"
                ]
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "smalltalk validator mcp server": {
            "smalltalk-validator": {
                "command": "uvx",
                "args": [
                    "--from",
                    "git+https://github.com/mumez/smalltalk-validator-mcp-server.git@main",
                    "smalltalk-validator-mcp-server"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "smalltalk validator mcp server": {
            "smalltalk-validator": {
                "command": "uvx",
                "args": [
                    "--from",
                    "git+https://github.com/mumez/smalltalk-validator-mcp-server.git@main",
                    "smalltalk-validator-mcp-server"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "smalltalk validator mcp server": {
            "smalltalk-validator": {
                "command": "uvx",
                "args": [
                    "--from",
                    "git+https://github.com/mumez/smalltalk-validator-mcp-server.git@main",
                    "smalltalk-validator-mcp-server"
                ]
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "smalltalk validator mcp server": {
            "smalltalk-validator": {
                "command": "uvx",
                "args": [
                    "--from",
                    "git+https://github.com/mumez/smalltalk-validator-mcp-server.git@main",
                    "smalltalk-validator-mcp-server"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "smalltalk validator mcp server": {
            "smalltalk-validator": {
                "command": "uvx",
                "args": [
                    "--from",
                    "git+https://github.com/mumez/smalltalk-validator-mcp-server.git@main",
                    "smalltalk-validator-mcp-server"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "smalltalk validator mcp server": {
            "smalltalk-validator": {
                "command": "uvx",
                "args": [
                    "--from",
                    "git+https://github.com/mumez/smalltalk-validator-mcp-server.git@main",
                    "smalltalk-validator-mcp-server"
                ]
            }
        }
    }
}

From the repository

Install with uvx --from git+https://github.com/mumez/smalltalk-validator-mcp-server.git@main smalltalk-validator-mcp-server or clone the repository and run uv run smalltalk-validator-mcp-server. Configure it as an MCP server in Cursor or Claude Code using the provided JSON or CLI commands. The server exposes five tools: validate_tonel_smalltalk_from_file, validate_tonel_smalltalk, validate_smalltalk_method_body, lint_tonel_smalltalk_from_file, and lint_tonel_smalltalk. Validation options include without-method-body to skip method body checking.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "smalltalk validator mcp server": {
            "smalltalk-validator": {
                "command": "uvx",
                "args": [
                    "--from",
                    "git+https://github.com/mumez/smalltalk-validator-mcp-server.git@main",
                    "smalltalk-validator-mcp-server"
                ]
            }
        }
    }
}

McpServers

{
    "smalltalk-validator": {
        "command": "uvx",
        "args": [
            "--from",
            "git+https://github.com/mumez/smalltalk-validator-mcp-server.git@main",
            "smalltalk-validator-mcp-server"
        ]
    }
}

smalltalk-validator-mcp-server

A simple MCP server for validating and linting Tonel formatted Smalltalk source code using
tree-sitter-tonel-smalltalk.

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

Tools

Validation 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

Validation Options

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

Linting Tools

lint_tonel_smalltalk_from_file(file_path)

- Lint Tonel formatted Smalltalk source code from a file

lint_tonel_smalltalk(file_content)

- Lint Tonel formatted Smalltalk source code from content string

See docs/lint-checks.md for the full list of checks.

Installation

Quick install (uvx)

Run directly without cloning:

uvx --from git+https://github.com/mumez/smalltalk-validator-mcp-server.git@main smalltalk-validator-mcp-server

Development setup (git clone)

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

Usage

Running the MCP Server

- Using uvx (recommended for quick run):

uvx --from git+https://github.com/mumez/smalltalk-validator-mcp-server.git@main smalltalk-validator-mcp-server

- From a cloned repo:

uv run smalltalk-validator-mcp-server

Configuration Examples

Cursor Configuration

Add to your .cursor/settings.json:

{
  "mcpServers": {
    "smalltalk-validator": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/mumez/smalltalk-validator-mcp-server.git@main",
        "smalltalk-validator-mcp-server"
      ]
    }
  }
}

If you prefer using a local clone, use this instead:

{
  "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 -- uvx --from git+https://github.com/mumez/smalltalk-validator-mcp-server.git@main smalltalk-validator-mcp-server

Using a local clone instead:

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

```python

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

smalltalk-validator-mcp-server

Tools

Validation Tools

validate_tonel_smalltalk_from_file(file_path, options)

validate_tonel_smalltalk(file_content, options)

validate_smalltalk_method_body(method_body_content)

Validation Options

Linting Tools

lint_tonel_smalltalk_from_file(file_path)

lint_tonel_smalltalk(file_content)

Installation

Quick install (uvx)

Development setup (git clone)

Usage

Running the MCP Server

Configuration Examples

Cursor Configuration

Claude Code Configuration

Tool Usage Examples

Validate Tonel file from filesystem

Install

More like this

Sequential Thinking

Filesystem

EverArt

Google Drive

Reactive Resume

FastMCP v2 🚀