Setup

Install Node.js v24 using nvm. After checking out the repository, run:

nvm install 24
nvm use 24
npm install

# Build

Compile the TypeScript sources before running tests:

npm run build

Running tests

Run the test suite with Node's test runner and ts-node to enable mocks:

npm run test

The tests/helpers/mock-mcp-server.js script provides a lightweight local MCP server used during tests so everything runs offline. All tests should pass without external downloads.

If network-dependent commands (like npx -y @modelcontextprotocol/server-*) fail, check network access.