npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@es11225599/systemone-mcp

v0.1.0

Published

stdio MCP server for any System One backend (Ollama nimble/tev/clef, TypeSafe jev, Kev, Laya). Run with npx or bunx, no build required.

Readme

systemone-mcp

MCP server for any System One backend (Ollama nimble/tev/clef, TypeSafe jev, Kev, Laya).

Exposes two stdio tools:

  • systemone_evaluate — answer typed choice / score / noul questions with a System One model
  • systemone_list_models — list available System One models on the configured backend

Thin Zod-validated passthrough: MCP tools -> fetch({baseUrl}/v1/systemone) with optional Bearer key. model is a free-form non-empty string (never a hard-coded enum).

Run it with npx or bunx — see Install.

Env

| Variable | Default | Notes | |---|---|---| | SYSTEMONE_BASE_URL | http://localhost:11434 | Must start with http:// or https://. Ollama default http://localhost:11434. | | SYSTEMONE_API_KEY | (unset) | Optional. TypeSafe cloud / Kev with key / Laya with LAYA_API_KEY. Sent as Authorization: Bearer <key>. | | SYSTEMONE_MODEL | nimble | Default model when the tool call omits model. Any of nimble / tev / clef / jev / kev / laya. |

See .env.example for a copy-paste starting point.

Install

No build, no clone, no npm install — the published package ships prebuilt, so npx/bunx fetch a ready-to-run server.

npx -y @es11225599/systemone-mcp
bunx @es11225599/systemone-mcp

Requires Node >= 20 (or Bun). First run downloads the package; later runs are cached.

Run

npx / bunx (recommended)

Point any MCP client at the runner. Nothing to build or install locally:

{
  "mcpServers": {
    "system-one": {
      "command": "npx",
      "args": ["-y", "@es11225599/systemone-mcp"],
      "env": {
        "SYSTEMONE_BASE_URL": "http://localhost:11434",
        "SYSTEMONE_MODEL": "nimble"
      }
    }
  }
}

With Bun, swap the command and args:

{
  "mcpServers": {
    "system-one": {
      "command": "bunx",
      "args": ["@es11225599/systemone-mcp"],
      "env": {
        "SYSTEMONE_BASE_URL": "http://localhost:11434",
        "SYSTEMONE_MODEL": "nimble"
      }
    }
  }
}

Both forward stdio, so the server is fully wired either way. If your client resolves binaries through a shell, npx.cmd / bunx.cmd are the Windows equivalents.

Claude Code

claude mcp add system-one \
  -e SYSTEMONE_BASE_URL=http://localhost:11434 \
  -e SYSTEMONE_MODEL=nimble \
  -- npx -y @es11225599/systemone-mcp

From a clone (development)

npm install
npm run build
SYSTEMONE_BASE_URL=http://localhost:11434 node dist/index.js

Windows PowerShell:

npm install
npm run build
$env:SYSTEMONE_BASE_URL="http://localhost:11434"; node dist/index.js

npm run dev (tsx) skips the build for local iteration.

For TypeSafe cloud / Kev / Laya, add "SYSTEMONE_API_KEY": "<key>" to env and point SYSTEMONE_BASE_URL at that backend.

Manual parity

Direct HTTP check against an Ollama backend running nimble (bypasses MCP, same endpoint the server calls):

curl http://localhost:11434/v1/systemone \
  -H 'Content-Type: application/json' \
  -d '{"model":"nimble","state":"Our checkout has returned 500 errors since 9am.","questions":{"label":{"type":"choice","instructions":"Which label fits?","criteria":{"billing":"Payments","bug":"Errors","account":"Login"}}}}'

Expected: JSON with model, answers.label, and usage (input_tokens / output_tokens).