Smalltalk Validator Mcp Server

What is smalltalk-validator-mcp-server?

A Model Context Protocol server for validating and linting Tonel‑formatted Smalltalk source code. It uses tree‑sitter‑tonel‑smalltalk to parse and check syntax and style. Designed for developers who want to verify AI‑generated Tonel files and method definitions before importing them into a real Smalltalk environment.

How to use smalltalk-validator-mcp-server?

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.

Key features of smalltalk-validator-mcp-server

• 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.

Use cases of smalltalk-validator-mcp-server

• Validate AI‑generated Tonel class definitions before loading.
• Lint existing Tonel files for style and length warnings.
• Check Smalltalk method body syntax in isolation.
• Integrate Smalltalk code quality checks into an AI‑assisted workflow.

FAQ from smalltalk-validator-mcp-server

What exactly does smalltalk-validator-mcp-server validate?

It validates Tonel‑formatted Smalltalk source code (files or strings) and individual Smalltalk method bodies. It checks both structure and syntax using tree‑sitter‑tonel‑smalltalk, and can optionally lint for style issues such as method length.

How do I install and run smalltalk-validator-mcp-server?

The quickest way is uvx --from git+https://github.com/mumez/smalltalk-validator-mcp-server.git@main smalltalk-validator-mcp-server. You can also clone the repo and run uv run smalltalk-validator-mcp-server. Dependencies are managed by uv.

Can I configure smalltalk-validator-mcp-server with Cursor or Claude Code?

Yes. For Cursor, add the server configuration to .cursor/settings.json. For Claude Code, use claude mcp add smalltalk-validator -- uvx ... (or the local clone equivalent). Example configurations are provided in the README.

What validation options are available?

The validation tools accept an options dictionary. The only documented option is without-method-body: true, which makes validation check only the Tonel structure without parsing method bodies (useful for testing).

Are there known limitations or security considerations?

The README does not document any specific limits or security warnings. The server is intended for local validation of Smalltalk code, and no authentication or transport details beyond standard MCP stdio are mentioned.