Skip to content

Installation

devlomingo edited this page Nov 16, 2026 · 1 revision

Installation

Requirement: Node.js 22.13 or newer (node --version). No database or other service is needed; state lives in a SQLite file.

npm (recommended)

npm install -g toolsmith-mcp
toolsmith-mcp --version

Or without installing: npx toolsmith-mcp demo.

Installing straight from git (npm install -g github:…) does not work: npm cannot build a TypeScript package during a global git install. Use npm or the tarball attached to each GitHub release.

Docker

git clone https://github.com/devlomingo/toolsmith-mcp && cd toolsmith-mcp
docker build -t toolsmith-mcp .
mkdir ~/toolsmith && cd ~/toolsmith
docker run --rm -v "$PWD:/work" toolsmith-mcp init
docker run -d --name toolsmith -p 127.0.0.1:7420:7420 -v "$PWD:/work" --env-file .env toolsmith-mcp

Inside the container the gateway binds 0.0.0.0 and refuses to start without server.mcpToken (which init generates). Publish the port on 127.0.0.1 unless you mean to expose it. A compose.yaml is included: docker compose run --rm toolsmith init, then docker compose up -d.

From source

git clone https://github.com/devlomingo/toolsmith-mcp && cd toolsmith-mcp
npm ci && npm run build
node dist/cli/index.js demo

Check the setup

toolsmith-mcp doctor

checks the Node version, config, tokens, imported integrations and upstream connections, and says what to fix.

Next: Connect Your Client.

Clone this wiki locally