Install

Karagöz is not on npm yet, so build it from source and put karagoz on your PATH.

From source

Not on npm yet. You need Node 22 or newer, and for each target what Requirements lists.

$ git clone https://github.com/yagizdo/karagoz-mcp.git
$ cd karagoz-mcp
$ npm install
$ npm run build
$ cd packages/karagoz
$ npm link

npm run build writes packages/karagoz/dist/. npm link, run in packages/karagoz, puts karagoz on your PATH. The examples on this site use karagoz; without the link, run node packages/karagoz/dist/cli.js from the clone instead.

Getting started runs your first commands.

To work on Karagöz itself: Development, the build, checks and smoke scripts.