sample-plugin

Define a plugin.json manifest listing each tool's name, description, command, and JSON Schema parameters, then place the executable scripts in a scripts/ directory. Tools receive parameters as JSON on stdin and print results to stdout.

Yes, plugin tools are language-agnostic because each tool declares its own command in plugin.json. This sample runs a Python script via python3 and a TypeScript script via npx tsx side by side.

Parameters are passed as a JSON object through stdin, which the script parses with json.loads in Python or JSON.parse in TypeScript. The tool prints its result to stdout and exits nonzero on errors.

The calculator validates input with a regex allowing only digits, whitespace, and basic arithmetic operators before evaluation. Expressions containing letters or other characters are rejected with an error and exit code 1.

The py_greet tool supports English, Chinese, and Japanese through the lang parameter, which accepts en, zh, or ja. If the language is omitted or unrecognized, it falls back to English.