@tonyweckstrom/mcp-doctor 0.0.0-stage → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Tony Weckström
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,181 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# mcp-doctor
+
+Terveystarkastus MCP-palvelimelle. Yksi komento kertoo, toimiiko palvelimesi: vastaako se `initialize`-kättelyyn, ovatko työkalujen kuvaukset ja skeemat kunnossa ja onnistuvatko oikeat työkalukutsut. Raportti on luettava ihmiselle ja koneelle (JSON), ja poistumiskoodi sopii CI:hin.
+
+*English summary: a CLI and GitHub Action that checks an MCP server's health: handshake, tool-schema lint and smoke calls with explicit example arguments. Human-readable or JSON report, exit code for CI, no API keys, no network access besides the server you point it at.*
+
+Miksi: MCP-asiakkaat (Claude Desktop, Cursor) antavat vähän tietoa, kun palvelin tai työkalun skeema on rikki. Työkalu vain puuttuu listalta tai malli käyttää sitä väärin, ja kehittäjä jää arvailemaan. mcp-doctor löytää ongelmat ennen asiakasta.
+
+## Asennus
+
+Ei asennusta: aja suoraan npm:stä (Node 22.12+ tai 24):
+
+```bash
+npx @tonyweckstrom/mcp-doctor -- node ./oma-palvelin/dist/index.js
+```
+
+Tai asenna globaalisti (komento on silloin `mcp-doctor`):
+
+```bash
+npm install -g @tonyweckstrom/mcp-doctor
+mcp-doctor --version
+```
+
+Tai lähteistä:
+
+```bash
+git clone https://github.com/tonyweckstrom1987/mcp-doctor.git
+cd mcp-doctor
+npm ci          # asentaa ja kääntää (prepare-skripti)
+node dist/bin.js --help
+```
+
+## Käyttö
+
+stdio-palvelin (komento annetaan `--`-merkin jälkeen):
+
+```bash
+npx @tonyweckstrom/mcp-doctor -- node ../oma-palvelin/dist/index.js
+```
+
+HTTP-palvelin (Streamable HTTP), tarvittaessa Bearer-tokenilla ympäristömuuttujasta:
+
+```bash
+export DOCTOR_TOKEN=...   # kirjoita itse, älä liitä tokenia komentoriville
+npx @tonyweckstrom/mcp-doctor --url http://127.0.0.1:3000/mcp --bearer-env DOCTOR_TOKEN
+```
+
+Esimerkkituloste (mcp-server-starter, savuajolla):
+
+```
+mcp-doctor: node ../starter/dist/index.js
+Palvelin: mcp-server-starter 0.1.0, 2 työkalua
+Savuajo:
+  OK     greet (4 ms)
+  OK     add (1 ms)
+Yhteenveto: 0 virhettä, 0 varoitusta, 0 huomiota -> OK
+```
+
+Ja kun palvelimessa on vikoja (testipalvelin, jossa on päällekkäisiä ja vajaasti kuvattuja työkaluja), tulos on virheitä ja poistumiskoodi `1`:
+
+```
+mcp-doctor: node bad-tools-server.mjs
+Palvelin: huono-palvelin 0.0.1, 4 työkalua
+VIRHE    [TOOL_DUPLICATE] dup: työkalun nimi esiintyy 2 kertaa
+VIRHE    [TOOL_NAME_INVALID] no desc!: nimi on tyhjä, yli 128 merkkiä tai sisältää sallittujen merkkien (A-Z a-z 0-9 _ - .) ulkopuolisia merkkejä
+VIRHE    [SCHEMA_REQUIRED_UNKNOWN] loose: pakollinen kenttä 'z' ei ole properties-listassa
+VAROITUS [TOOL_DESC_MISSING] no desc!: kuvaus puuttuu: malli ei tiedä milloin työkalua kuuluu käyttää
+VAROITUS [SCHEMA_PROP_UNTYPED] loose: kentällä 'x' ei ole tyyppiä (type/enum/const/$ref/anyOf/oneOf/allOf): skeema on liian väljä
+VAROITUS [SCHEMA_PROP_DESC_MISSING] loose: kentältä 'x' puuttuu kuvaus
+VAROITUS [SCHEMA_PROP_DESC_MISSING] loose: kentältä 'y' puuttuu kuvaus
+Yhteenveto: 3 virhettä, 4 varoitusta, 0 huomiota -> EPÄONNISTUI
+```
+
+| Valinta | Selitys |
+| --- | --- |
+| `--smoke <tiedosto>` | savuajo: kutsuu vain tiedostossa nimetyt työkalut |
+| `--json` | raportti JSONina |
+| `--strict` | varoituksetkin kaatavat ajon |
+| `--timeout-ms <luku>` | yksittäisen pyynnön aikakatkaisu, oletus 10000 |
+| `--env <NIMI>` | välittää ympäristömuuttujan stdio-palvelimelle (toistettava) |
+| `--bearer-env <NIMI>` | HTTP-palvelimen Bearer-token tästä muuttujasta |
+| `--version` | tulostaa version |
+
+Poistumiskoodit: `0` kunnossa, `1` löydöksiä (virhe, tai varoitus `--strict`-tilassa), `2` käyttö- tai tiedostovirhe.
+
+## Mitä tarkistetaan
+
+| Tunniste | Vakavuus | Mitä |
+| --- | --- | --- |
+| `CONNECT_FAILED` | virhe | yhteys tai `initialize` epäonnistui, myös tuntematon protokollaversio. Viestissä näkyy stdio-palvelimen viimeinen stderr-teksti |
+| `SERVER_INFO_MISSING` | varoitus | palvelin ei kerro nimeään |
+| `TOOLS_CAPABILITY_MISSING` | varoitus | palvelin ei ilmoita tools-kykyä |
+| `TOOLS_LIST_FAILED` | virhe | `tools/list` epäonnistui |
+| `TOOLS_EMPTY` | varoitus | tools-kyky ilmoitettu, mutta lista tyhjä |
+| `TOOLS_PAGINATION_LIMIT` | varoitus | lista jatkui yli 50 sivua, luku keskeytettiin |
+| `TOOL_DUPLICATE` | virhe | sama nimi useammin kuin kerran |
+| `TOOL_NAME_INVALID` | virhe | tyhjä, yli 128 merkkiä tai muita merkkejä kuin `A-Z a-z 0-9 _ - .` |
+| `TOOL_NAME_PORTABILITY` | varoitus | ei sovi muotoon `[A-Za-z0-9_-]{1,64}`, jota osa asiakkaista vaatii |
+| `TOOL_DESC_MISSING` / `TOOL_DESC_SHORT` | varoitus / huomio | kuvaus puuttuu / alle 20 merkkiä |
+| `SCHEMA_NOT_OBJECT` | virhe | syöteskeema puuttuu tai sen `type` ei ole `object` |
+| `SCHEMA_REQUIRED_INVALID` / `SCHEMA_REQUIRED_UNKNOWN` | virhe | `required` ei ole merkkijonolista / viittaa kenttään, jota ei ole |
+| `SCHEMA_PROP_DESC_MISSING` | varoitus | kentältä puuttuu kuvaus |
+| `SCHEMA_PROP_UNTYPED` | varoitus | kentällä ei ole `type`/`enum`/`const`/`$ref`/`anyOf`/`oneOf`/`allOf` |
+| `OUTPUT_SCHEMA_NOT_OBJECT` | virhe | `outputSchema` ei ole `object` |
+| `SMOKE_TOOL_NOT_FOUND` | virhe | savuajotiedosto nimeää työkalun, jota palvelimella ei ole |
+| `SMOKE_TOOL_ERROR` | virhe | työkalu palautti `isError`, vaikka virhettä ei odotettu |
+| `SMOKE_EXPECTED_ERROR` | virhe | odotettu virhe jäi tulematta |
+| `SMOKE_CALL_FAILED` | virhe | kutsu epäonnistui (aikakatkaisu, protokollavirhe, `outputSchema`-vaatimus rikottu) |
+| `SMOKE_EMPTY_RESULT` | varoitus | tulos on tyhjä |
+| `SMOKE_SLOW` | varoitus | vastaus kesti yli `maxMs` (oletus 5000) |
+
+## Savuajo
+
+Savuajo kutsuu **vain** tiedostossa nimettyjä työkaluja, annetuilla argumenteilla. Työkaluja ei kutsuta arvaamalla, koska työkalu voi muuttaa dataa. Jätä muokkaavat työkalut pois tai käytä niille testiympäristöä.
+
+```json
+{
+  "calls": [
+    { "tool": "greet", "arguments": { "name": "Tony" } },
+    { "tool": "poista_kaikki", "arguments": {}, "expectError": true },
+    { "tool": "hidas_haku", "arguments": { "q": "x" }, "maxMs": 15000 }
+  ]
+}
+```
+
+Kentät: `tool` (pakollinen), `arguments` (oletus `{}`), `expectError` (oletus `false`), `maxMs` (oletus 5000). Pelkkä taulukko käy myös.
+
+## GitHub Action
+
+```yaml
+- uses: actions/checkout@v7
+- run: npm ci && npm run build        # oma palvelimesi
+- uses: tonyweckstrom1987/mcp-doctor@v0.2.0
+  with:
+    command: node dist/index.js
+    smoke: smoke.json
+    strict: "true"
+```
+
+Lukitse Action versiotagiin (`@v0.2.0`) tai tiukemmin commit-SHA:han, älä `@main`-haaraan. Syötteet: `command` tai `url`, `smoke`, `strict`, `timeout-ms`, `env-names`, `bearer-env`. Stdio-palvelin näkee vain nimeämäsi ympäristömuuttujat: aseta arvot action-askeleen `env`-lohkossa ja listaa nimet syötteellä `env-names` (välilyönnein erotettuna). HTTP-palvelimen tokenin aseta samoin `env`-lohkossa secretistä ja anna muuttujan nimi syötteellä `bearer-env`. Syötteet välitetään kuoreen ympäristömuuttujina, ei komentoriville, joten ne eivät voi injektoida komentoja.
+
+## Turvallisuus
+
+- Työkalu käynnistää komennon, jonka itse annat, ja puhuu vain sille palvelimelle. Muita verkkoyhteyksiä tai API-avaimia ei ole.
+- Stdio-palvelin saa vain `PATH`- ja perusmuuttujat. Muut ympäristömuuttujat välitetään vain nimeämällä ne `--env`-valinnalla.
+- Bearer-token luetaan ympäristömuuttujasta, ei komentoriviltä, eikä sitä tulosteta. Tulostuva kohde-osoite jättää kyselyparametrit pois.
+- Raportti ei sisällä työkalujen tuloksia, vain virheen ensimmäisen tekstirivin (enintään 300 merkkiä).
+- Yhteysvirheen viestiin liitetään stdio-palvelimen viimeinen stderr-teksti. Jos palvelimesi kirjoittaa lokiin salaisuuksia, ne päätyvät CI-lokiin.
+
+## Vaihtoehtoja ja miksi tämä
+
+Tilanne 16.10.2026. MCP-palvelimen testaamiseen on jo muitakin työkaluja, ja jotkut niistä ovat laajempia kuin tämä:
+
+- [`@mcpjam/cli`](https://www.npmjs.com/package/@mcpjam/cli) on laaja testaus- ja virheenetsintätyökalu: yhteystarkistukset, OAuth-vaatimustenmukaisuus, protokollatarkistukset, työkalujen vertailu ja pilvipalvelu. Jos tarvitset OAuth-testejä tai kattavaa protokollakonformanssia, käytä sitä. Se kerää oletuksena anonyymiä käyttötilastoa (poistettavissa valinnalla `--no-telemetry`).
+- MCP Inspector -tyyppiset työkalut (esim. `@modelcontextprotocol/inspector`) on tehty palvelimen käsin tutkimiseen ja kokeiluun selaimessa tai komentorivillä, ei pelkkään pass/fail-tarkistukseen CI:ssä.
+
+mcp-doctor on tarkoituksella pieni ja rajattu yhteen tehtävään: yksi komento CI:ssä, joka kaatuu, kun palvelin tai sen työkalukuvaukset ovat rikki. Erot:
+
+- **Kuvausten laatu mallin kannalta:** tarkistaa, että työkalulla on kuvaus ja että skeeman kentät ovat tyypitetty ja kuvattu, koska malli valitsee ja täyttää työkalut näiden perusteella.
+- **Savuajo vain nimeämillesi työkaluille:** työkaluja kutsutaan vain tiedostossa (`--smoke`) nimetyillä, itse määritellyillä argumenteilla. Mitään ei kutsuta arvaamalla.
+- **Ei verkkoa muualle:** työkalu puhuu vain osoittamallesi palvelimelle. Ei API-avaimia, ei tilastoja, ei tiliä.
+- **Eristetty Action:** stdio-palvelin näkee vain nimeämäsi ympäristömuuttujat, ja Actionin syötteet eivät pääse komentoriville.
+- **Pieni ja testattu:** vähän koodia, 80 testiä oikeilla stdio- ja HTTP-testipalvelimilla.
+
+## Rajaukset
+
+Ei tue vanhaa SSE-siirtoa eikä OAuth-kirjautumista. Tarkistaa työkalut, ei `resources`- tai `prompts`-osioita. JSON Schema -validointi on kevyt (rakenne, `required`, tyypit, kuvaukset), ei täyttä skeemavalidointia.
+
+## Kehitys
+
+```bash
+npm ci
+npm run typecheck
+npm test        # 80 testiä, käynnistää oikeita stdio- ja HTTP-testipalvelimia
+```
+
+Testit ajetaan oikeita MCP-palvelimia vastaan (`test/fixtures/`): kunnossa oleva, huonosti määritelty, väärää protokollaversiota puhuva, heti kaatuva sekä sivuttava. Ennen julkaisua koodiin tehtiin tahallisia rikkomisia (mutaatiot), (22 kappaletta), ja jokainen niistä kaatoi testin.
+
+## Lisenssi
+
+MIT

package/dist/bin.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+import { main, realIo } from "./cli.js";
+main(process.argv.slice(2), realIo()).then((code) => {
+    process.exitCode = code;
+});
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAExC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;IAClD,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;AAC1B,CAAC,CAAC,CAAC"}

package/dist/cli.js

@@ -0,0 +1,185 @@
+import { readFileSync } from "node:fs";
+import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
+import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
+import { formatJson, formatText } from "./report.js";
+import { diagnose } from "./runner.js";
+import { parseSmokeSpec } from "./smoke.js";
+import { UsageError } from "./types.js";
+import { VERSIO } from "./versio.js";
+export const EXIT_OK = 0;
+export const EXIT_FINDINGS = 1;
+export const EXIT_USAGE = 2;
+export const USAGE = `mcp-doctor - MCP-palvelimen terveystarkastus
+
+Käyttö:
+  mcp-doctor [valinnat] -- <komento> [argumentit...]     stdio-palvelin
+  mcp-doctor [valinnat] --url <http(s)-osoite>           HTTP-palvelin (Streamable HTTP)
+
+Valinnat:
+  --smoke <tiedosto>     savuajo: kutsuu vain tiedostossa nimetyt työkalut
+  --json                 tulosta raportti JSONina
+  --strict               varoituksetkin kaatavat ajon (exit 1)
+  --timeout-ms <luku>    yksittäisen pyynnön aikakatkaisu, oletus 10000
+  --env <NIMI>           välitä ympäristömuuttuja stdio-palvelimelle (toistettava)
+  --bearer-env <NIMI>    lue HTTP-palvelimen Bearer-token tästä ympäristömuuttujasta
+  --version              tulosta versio
+  --help                 tämä ohje
+
+Poistumiskoodit: 0 kunnossa, 1 löydöksiä (virhe, tai varoitus --strict-tilassa), 2 käyttö- tai tiedostovirhe.
+`;
+const BOOL_FLAGS = new Set(["json", "strict", "help", "version"]);
+const VALUE_FLAGS = new Set(["smoke", "timeout-ms", "env", "bearer-env", "url"]);
+function parseArgs(argv) {
+    const flags = new Map();
+    const bools = new Set();
+    let command = [];
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if (a === "--") {
+            command = argv.slice(i + 1);
+            break;
+        }
+        if (!a.startsWith("--"))
+            throw new UsageError(`Odottamaton argumentti '${a}' (palvelimen komento tulee '--'-merkin jälkeen)`);
+        const name = a.slice(2);
+        if (BOOL_FLAGS.has(name))
+            bools.add(name);
+        else if (VALUE_FLAGS.has(name)) {
+            const v = argv[++i];
+            if (v === undefined || v.startsWith("--"))
+                throw new UsageError(`Valinta --${name} tarvitsee arvon`);
+            flags.set(name, [...(flags.get(name) ?? []), v]);
+        }
+        else
+            throw new UsageError(`Tuntematon valinta --${name}`);
+    }
+    return { command, flags, bools };
+}
+function one(args, name) {
+    const v = args.flags.get(name);
+    if (!v)
+        return undefined;
+    if (v.length > 1)
+        throw new UsageError(`Valinta --${name} saa esiintyä vain kerran`);
+    return v[0];
+}
+/** Ajaa komentorivin ja palauttaa poistumiskoodin. Ei kutsu process.exit-funktiota. */
+export async function main(argv, io) {
+    try {
+        // Vain '--'-merkkiä edeltävät argumentit ovat meidän: palvelimen oma '--help' ei saa laukaista ohjetta.
+        const ennenErotinta = argv.includes("--") ? argv.slice(0, argv.indexOf("--")) : argv;
+        if (ennenErotinta.includes("--version")) {
+            io.stdout(`${VERSIO}\n`);
+            return EXIT_OK;
+        }
+        if (ennenErotinta.includes("--help")) {
+            io.stdout(USAGE);
+            return EXIT_OK;
+        }
+        if (argv.length === 0) {
+            io.stderr(USAGE);
+            return EXIT_USAGE;
+        }
+        const args = parseArgs(argv);
+        const url = one(args, "url");
+        if (url !== undefined && args.command.length > 0)
+            throw new UsageError("Anna joko --url tai komento '--'-merkin jälkeen, ei molempia");
+        if (url === undefined && args.command.length === 0)
+            throw new UsageError("Anna palvelin: --url <osoite> tai komento '--'-merkin jälkeen");
+        const timeoutRaw = one(args, "timeout-ms");
+        const timeoutMs = timeoutRaw === undefined ? 10000 : Number(timeoutRaw);
+        if (!Number.isInteger(timeoutMs) || timeoutMs < 1)
+            throw new UsageError("--timeout-ms täytyy olla positiivinen kokonaisluku");
+        const smokePath = one(args, "smoke");
+        let smoke;
+        if (smokePath !== undefined) {
+            let text;
+            try {
+                text = io.readFile(smokePath);
+            }
+            catch {
+                throw new UsageError(`Savuajotiedostoa '${smokePath}' ei voi lukea`);
+            }
+            smoke = parseSmokeSpec(text);
+        }
+        let transport;
+        let target;
+        let stderrTail;
+        if (url !== undefined) {
+            let parsed;
+            try {
+                parsed = new URL(url);
+            }
+            catch {
+                throw new UsageError(`Virheellinen osoite '${url}'`);
+            }
+            if (parsed.protocol !== "http:" && parsed.protocol !== "https:")
+                throw new UsageError("--url: vain http ja https sallitaan");
+            if (args.flags.has("env"))
+                throw new UsageError("--env koskee vain stdio-palvelinta");
+            const bearerEnv = one(args, "bearer-env");
+            let requestInit;
+            if (bearerEnv !== undefined) {
+                const token = io.env[bearerEnv];
+                if (!token)
+                    throw new UsageError(`Ympäristömuuttuja ${bearerEnv} on tyhjä tai puuttuu`);
+                requestInit = { headers: { Authorization: `Bearer ${token}` } };
+            }
+            transport = new StreamableHTTPClientTransport(parsed, requestInit ? { requestInit } : undefined);
+            target = `${parsed.origin}${parsed.pathname}`; // ei kyselyparametreja eikä tunnuksia tulosteisiin
+        }
+        else {
+            if (args.flags.has("bearer-env"))
+                throw new UsageError("--bearer-env koskee vain --url-palvelinta");
+            const env = {};
+            for (const name of args.flags.get("env") ?? []) {
+                const v = io.env[name];
+                if (v === undefined)
+                    throw new UsageError(`Ympäristömuuttujaa ${name} ei ole asetettu`);
+                env[name] = v;
+            }
+            const [command, ...rest] = args.command;
+            const stdio = new StdioClientTransport({ command, args: rest, env: { ...getSafeEnv(io.env), ...env }, stderr: "pipe" });
+            let tail = "";
+            stdio.stderr?.on("data", (d) => {
+                tail = (tail + d.toString()).slice(-1000);
+            });
+            stderrTail = () => tail;
+            transport = stdio;
+            target = args.command.join(" ");
+        }
+        const report = await diagnose({ transport, target, smoke, timeoutMs, strict: args.bools.has("strict"), stderrTail });
+        io.stdout(args.bools.has("json") ? formatJson(report) : formatText(report));
+        return report.ok ? EXIT_OK : EXIT_FINDINGS;
+    }
+    catch (err) {
+        if (err instanceof UsageError) {
+            io.stderr(`Virhe: ${err.message}\n\n${USAGE}`);
+            return EXIT_USAGE;
+        }
+        io.stderr(`Odottamaton virhe: ${err instanceof Error ? err.message : String(err)}\n`);
+        return EXIT_USAGE;
+    }
+}
+/** Vain PATH ja perusmuuttujat: tarkastettava palvelin ei näe muuta ympäristöä kuin --env:llä nimetyn. */
+function getSafeEnv(env) {
+    const keep = process.platform === "win32"
+        ? ["PATH", "PATHEXT", "SYSTEMROOT", "COMSPEC", "TEMP", "TMP", "USERPROFILE", "APPDATA", "LOCALAPPDATA", "HOMEDRIVE", "HOMEPATH"]
+        : ["PATH", "HOME", "LANG", "TMPDIR", "SHELL", "USER"];
+    const out = {};
+    for (const k of keep) {
+        const v = env[k];
+        if (v !== undefined && !v.startsWith("()"))
+            out[k] = v;
+    }
+    return out;
+}
+export function realIo() {
+    return {
+        stdout: (s) => process.stdout.write(s),
+        stderr: (s) => process.stderr.write(s),
+        env: process.env,
+        readFile: (p) => readFileSync(p, "utf8"),
+    };
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AAEnG,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,CAAC;AACzB,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC;AAC/B,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC;AAS5B,MAAM,CAAC,MAAM,KAAK,GAAG;;;;;;;;;;;;;;;;;CAiBpB,CAAC;AAQF,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;AAClE,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,CAAC,CAAC,CAAC;AAEjF,SAAS,SAAS,CAAC,IAAc;IAC/B,MAAM,KAAK,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC1C,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,IAAI,OAAO,GAAa,EAAE,CAAC;IAC3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;YACf,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAC5B,MAAM;QACR,CAAC;QACD,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,UAAU,CAAC,2BAA2B,CAAC,kDAAkD,CAAC,CAAC;QAC9H,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACxB,IAAI,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;aACrC,IAAI,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/B,MAAM,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;YACpB,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC;gBAAE,MAAM,IAAI,UAAU,CAAC,aAAa,IAAI,kBAAkB,CAAC,CAAC;YACrG,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACnD,CAAC;;YAAM,MAAM,IAAI,UAAU,CAAC,wBAAwB,IAAI,EAAE,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AACnC,CAAC;AAED,SAAS,GAAG,CAAC,IAAU,EAAE,IAAY;IACnC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IACzB,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,aAAa,IAAI,2BAA2B,CAAC,CAAC;IACrF,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;AACd,CAAC;AAED,uFAAuF;AACvF,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,IAAc,EAAE,EAAS;IAClD,IAAI,CAAC;QACH,wGAAwG;QACxG,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACrF,IAAI,aAAa,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;YACxC,EAAE,CAAC,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,CAAC;YACzB,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,IAAI,aAAa,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YACrC,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACjB,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACjB,OAAO,UAAU,CAAC;QACpB,CAAC;QACD,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QAC7B,MAAM,GAAG,GAAG,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC7B,IAAI,GAAG,KAAK,SAAS,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;YAAE,MAAM,IAAI,UAAU,CAAC,8DAA8D,CAAC,CAAC;QACvI,IAAI,GAAG,KAAK,SAAS,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,MAAM,IAAI,UAAU,CAAC,+DAA+D,CAAC,CAAC;QAC1I,MAAM,UAAU,GAAG,GAAG,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QAC3C,MAAM,SAAS,GAAG,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QACxE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,SAAS,GAAG,CAAC;YAAE,MAAM,IAAI,UAAU,CAAC,oDAAoD,CAAC,CAAC;QAE9H,MAAM,SAAS,GAAG,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACrC,IAAI,KAAK,CAAC;QACV,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,IAAI,IAAY,CAAC;YACjB,IAAI,CAAC;gBACH,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;YAChC,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,IAAI,UAAU,CAAC,qBAAqB,SAAS,gBAAgB,CAAC,CAAC;YACvE,CAAC;YACD,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;QAC/B,CAAC;QAED,IAAI,SAAoB,CAAC;QACzB,IAAI,MAAc,CAAC;QACnB,IAAI,UAAsC,CAAC;QAC3C,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YACtB,IAAI,MAAW,CAAC;YAChB,IAAI,CAAC;gBACH,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;YACxB,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,IAAI,UAAU,CAAC,wBAAwB,GAAG,GAAG,CAAC,CAAC;YACvD,CAAC;YACD,IAAI,MAAM,CAAC,QAAQ,KAAK,OAAO,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ;gBAAE,MAAM,IAAI,UAAU,CAAC,qCAAqC,CAAC,CAAC;YAC7H,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC;gBAAE,MAAM,IAAI,UAAU,CAAC,oCAAoC,CAAC,CAAC;YACtF,MAAM,SAAS,GAAG,GAAG,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;YAC1C,IAAI,WAAoC,CAAC;YACzC,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;gBAC5B,MAAM,KAAK,GAAG,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;gBAChC,IAAI,CAAC,KAAK;oBAAE,MAAM,IAAI,UAAU,CAAC,qBAAqB,SAAS,uBAAuB,CAAC,CAAC;gBACxF,WAAW,GAAG,EAAE,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,KAAK,EAAE,EAAE,EAAE,CAAC;YAClE,CAAC;YACD,SAAS,GAAG,IAAI,6BAA6B,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;YACjG,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,mDAAmD;QACpG,CAAC;aAAM,CAAC;YACN,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC;gBAAE,MAAM,IAAI,UAAU,CAAC,2CAA2C,CAAC,CAAC;YACpG,MAAM,GAAG,GAA2B,EAAE,CAAC;YACvC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;gBAC/C,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBACvB,IAAI,CAAC,KAAK,SAAS;oBAAE,MAAM,IAAI,UAAU,CAAC,sBAAsB,IAAI,kBAAkB,CAAC,CAAC;gBACxF,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAChB,CAAC;YACD,MAAM,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC;YACxC,MAAM,KAAK,GAAG,IAAI,oBAAoB,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,GAAG,UAAU,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,GAAG,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;YACxH,IAAI,IAAI,GAAG,EAAE,CAAC;YACd,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,CAAkB,EAAE,EAAE;gBAC9C,IAAI,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC;YAC5C,CAAC,CAAC,CAAC;YACH,UAAU,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC;YACxB,SAAS,GAAG,KAAK,CAAC;YAClB,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClC,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC;QACrH,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;QAC5E,OAAO,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC;IAC7C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,UAAU,EAAE,CAAC;YAC9B,EAAE,CAAC,MAAM,CAAC,UAAU,GAAG,CAAC,OAAO,OAAO,KAAK,EAAE,CAAC,CAAC;YAC/C,OAAO,UAAU,CAAC;QACpB,CAAC;QACD,EAAE,CAAC,MAAM,CAAC,sBAAsB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACtF,OAAO,UAAU,CAAC;IACpB,CAAC;AACH,CAAC;AAED,0GAA0G;AAC1G,SAAS,UAAU,CAAC,GAAuC;IACzD,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO;QACvC,CAAC,CAAC,CAAC,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,cAAc,EAAE,WAAW,EAAE,UAAU,CAAC;QAChI,CAAC,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IACxD,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;QACjB,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACzD,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,MAAM;IACpB,OAAO;QACL,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACtC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACtC,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC;KACzC,CAAC;AACJ,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export { diagnose } from "./runner.js";
+export { lintTools } from "./lint.js";
+export { parseSmokeSpec } from "./smoke.js";
+export { formatJson, formatText } from "./report.js";
+export * from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACrD,cAAc,YAAY,CAAC"}

package/dist/lint.js

@@ -0,0 +1,82 @@
+const NAME_STRICT = /^[A-Za-z0-9_-]{1,64}$/;
+const NAME_SPEC = /^[A-Za-z0-9_.-]{1,128}$/;
+const TYPE_KEYS = ["type", "enum", "const", "$ref", "anyOf", "oneOf", "allOf"];
+const SHORT_DESCRIPTION = 20;
+function isRecord(v) {
+    return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+function find(id, severity, tool, message) {
+    return { id, severity, tool, message };
+}
+function lintSchema(tool, schema, kind) {
+    const out = [];
+    const label = kind === "input" ? "syöteskeema" : "tulosskeema";
+    if (!isRecord(schema) || schema.type !== "object") {
+        out.push(find(kind === "input" ? "SCHEMA_NOT_OBJECT" : "OUTPUT_SCHEMA_NOT_OBJECT", "error", tool, `${label} puuttuu tai sen type ei ole "object"`));
+        return out;
+    }
+    const props = isRecord(schema.properties) ? schema.properties : undefined;
+    if (kind === "output")
+        return out;
+    const required = schema.required;
+    if (required !== undefined) {
+        if (!Array.isArray(required) || required.some((r) => typeof r !== "string")) {
+            out.push(find("SCHEMA_REQUIRED_INVALID", "error", tool, "required ei ole merkkijonolista"));
+        }
+        else {
+            for (const r of required) {
+                if (!props || !(r in props)) {
+                    out.push(find("SCHEMA_REQUIRED_UNKNOWN", "error", tool, `pakollinen kenttä '${r}' ei ole properties-listassa`));
+                }
+            }
+        }
+    }
+    if (props) {
+        for (const [name, def] of Object.entries(props)) {
+            if (!isRecord(def)) {
+                out.push(find("SCHEMA_PROP_UNTYPED", "warning", tool, `kentän '${name}' skeema ei ole objekti`));
+                continue;
+            }
+            if (!TYPE_KEYS.some((k) => k in def)) {
+                out.push(find("SCHEMA_PROP_UNTYPED", "warning", tool, `kentällä '${name}' ei ole tyyppiä (type/enum/const/$ref/anyOf/oneOf/allOf): skeema on liian väljä`));
+            }
+            if (typeof def.description !== "string" || def.description.trim() === "") {
+                out.push(find("SCHEMA_PROP_DESC_MISSING", "warning", tool, `kentältä '${name}' puuttuu kuvaus`));
+            }
+        }
+    }
+    return out;
+}
+/** Tarkistaa työkalulistan ja niiden skeemat. Puhdas funktio, ei verkkoa. */
+export function lintTools(tools) {
+    const out = [];
+    const seen = new Map();
+    for (const t of tools)
+        seen.set(t.name, (seen.get(t.name) ?? 0) + 1);
+    for (const [name, n] of seen) {
+        if (n > 1)
+            out.push(find("TOOL_DUPLICATE", "error", name, `työkalun nimi esiintyy ${n} kertaa`));
+    }
+    const reported = new Set();
+    for (const t of tools) {
+        if (reported.has(t.name))
+            continue; // duplikaatin skeema tarkistetaan kerran
+        reported.add(t.name);
+        if (!NAME_SPEC.test(t.name)) {
+            out.push(find("TOOL_NAME_INVALID", "error", t.name, "nimi on tyhjä, yli 128 merkkiä tai sisältää sallittujen merkkien (A-Z a-z 0-9 _ - .) ulkopuolisia merkkejä"));
+        }
+        else if (!NAME_STRICT.test(t.name)) {
+            out.push(find("TOOL_NAME_PORTABILITY", "warning", t.name, "nimi ei sovi muotoon [A-Za-z0-9_-]{1,64}, jota osa asiakkaista (esim. Claude API) vaatii"));
+        }
+        const desc = typeof t.description === "string" ? t.description.trim() : "";
+        if (desc === "")
+            out.push(find("TOOL_DESC_MISSING", "warning", t.name, "kuvaus puuttuu: malli ei tiedä milloin työkalua kuuluu käyttää"));
+        else if (desc.length < SHORT_DESCRIPTION)
+            out.push(find("TOOL_DESC_SHORT", "info", t.name, `kuvaus on hyvin lyhyt (${desc.length} merkkiä)`));
+        out.push(...lintSchema(t.name, t.inputSchema, "input"));
+        if (t.outputSchema !== undefined)
+            out.push(...lintSchema(t.name, t.outputSchema, "output"));
+    }
+    return out;
+}
+//# sourceMappingURL=lint.js.map

package/dist/lint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint.js","sourceRoot":"","sources":["../src/lint.ts"],"names":[],"mappings":"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"}

package/dist/report.js

@@ -0,0 +1,30 @@
+export function summarize(findings) {
+    return {
+        errors: findings.filter((f) => f.severity === "error").length,
+        warnings: findings.filter((f) => f.severity === "warning").length,
+        infos: findings.filter((f) => f.severity === "info").length,
+    };
+}
+const LABEL = { error: "VIRHE   ", warning: "VAROITUS", info: "HUOMIO  " };
+const ORDER = { error: 0, warning: 1, info: 2 };
+export function formatText(r) {
+    const lines = [];
+    lines.push(`mcp-doctor: ${r.target}`);
+    lines.push(r.server ? `Palvelin: ${r.server.name} ${r.server.version}, ${r.toolCount} työkalua` : "Palvelin: ei tietoja (yhteys ei onnistunut)");
+    const sorted = [...r.findings].sort((a, b) => ORDER[a.severity] - ORDER[b.severity]);
+    for (const f of sorted) {
+        lines.push(`${LABEL[f.severity]} [${f.id}]${f.tool ? ` ${f.tool}:` : ""} ${f.message}`);
+    }
+    if (r.smoke.length > 0) {
+        lines.push("Savuajo:");
+        for (const s of r.smoke)
+            lines.push(`  ${s.ok ? "OK    " : "VIRHE "} ${s.tool} (${s.ms} ms)`);
+    }
+    const { errors, warnings, infos } = r.summary;
+    lines.push(`Yhteenveto: ${errors} virhettä, ${warnings} varoitusta, ${infos} huomiota -> ${r.ok ? "OK" : "EPÄONNISTUI"}`);
+    return lines.join("\n") + "\n";
+}
+export function formatJson(r) {
+    return JSON.stringify(r, null, 2) + "\n";
+}
+//# sourceMappingURL=report.js.map

package/dist/report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.js","sourceRoot":"","sources":["../src/report.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,SAAS,CAAC,QAAmB;IAC3C,OAAO;QACL,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,MAAM;QAC7D,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,MAAM;QACjE,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC,MAAM;KAC5D,CAAC;AACJ,CAAC;AAED,MAAM,KAAK,GAAG,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAW,CAAC;AACpF,MAAM,KAAK,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAW,CAAC;AAEzD,MAAM,UAAU,UAAU,CAAC,CAAS;IAClC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;IACtC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,KAAK,CAAC,CAAC,SAAS,WAAW,CAAC,CAAC,CAAC,6CAA6C,CAAC,CAAC;IACjJ,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;IACrF,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IAC1F,CAAC;IACD,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACvB,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK;YAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IAChG,CAAC;IACD,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC;IAC9C,KAAK,CAAC,IAAI,CAAC,eAAe,MAAM,cAAc,QAAQ,gBAAgB,KAAK,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC;IAC1H,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,CAAS;IAClC,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;AAC3C,CAAC"}

package/dist/runner.js

@@ -0,0 +1,120 @@
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { lintTools } from "./lint.js";
+import { summarize } from "./report.js";
+import { VERSIO } from "./versio.js";
+const MAX_PAGES = 50;
+const MAX_MESSAGE = 300;
+function short(text) {
+    const one = text.replace(/\s+/g, " ").trim();
+    return one.length > MAX_MESSAGE ? one.slice(0, MAX_MESSAGE) + "…" : one;
+}
+function errText(e) {
+    return short(e instanceof Error ? e.message : String(e));
+}
+function firstText(content) {
+    if (!Array.isArray(content))
+        return "";
+    for (const c of content) {
+        if (c && typeof c === "object" && c.type === "text" && typeof c.text === "string") {
+            return short(c.text);
+        }
+    }
+    return "";
+}
+function build(opts, server, toolCount, findings, smoke) {
+    const summary = summarize(findings);
+    const ok = summary.errors === 0 && (!opts.strict || summary.warnings === 0);
+    return { version: 1, target: opts.target, server, toolCount, findings, smoke, summary, ok };
+}
+/** Yhdistää palvelimeen, tarkistaa työkalut ja ajaa savuajon. Ei koskaan heitä: virheet ovat löydöksiä. */
+export async function diagnose(opts) {
+    const findings = [];
+    const smokeResults = [];
+    // Huom: SDK:n asiakas tarkistaa itse outputSchema-vaatimuksen (puuttuva tai virheellinen structuredContent
+    // heittää virheen), ja se näkyy löydöksenä SMOKE_CALL_FAILED.
+    const client = new Client({ name: "mcp-doctor", version: VERSIO });
+    try {
+        try {
+            await client.connect(opts.transport, { timeout: opts.timeoutMs });
+        }
+        catch (e) {
+            const tail = opts.stderrTail?.().trim();
+            const extra = tail ? ` | palvelimen stderr: ${short(tail)}` : "";
+            findings.push({ id: "CONNECT_FAILED", severity: "error", message: `yhteys tai initialize-kättely epäonnistui: ${errText(e)}${extra}` });
+            return build(opts, null, 0, findings, smokeResults);
+        }
+        const info = client.getServerVersion();
+        const server = info ? { name: String(info.name), version: String(info.version) } : null;
+        if (!server || !server.name) {
+            findings.push({ id: "SERVER_INFO_MISSING", severity: "warning", message: "palvelin ei kertonut nimeään ja versiotaan (serverInfo)" });
+        }
+        const caps = client.getServerCapabilities();
+        const tools = [];
+        if (!caps?.tools) {
+            findings.push({ id: "TOOLS_CAPABILITY_MISSING", severity: "warning", message: "palvelin ei ilmoita tools-kykyä, työkaluja ei listata" });
+        }
+        else {
+            let cursor;
+            let pages = 0;
+            try {
+                do {
+                    const res = await client.listTools(cursor ? { cursor } : undefined, { timeout: opts.timeoutMs });
+                    tools.push(...res.tools);
+                    cursor = res.nextCursor;
+                    pages++;
+                } while (cursor && pages < MAX_PAGES);
+                if (cursor)
+                    findings.push({ id: "TOOLS_PAGINATION_LIMIT", severity: "warning", message: `työkalulistaus keskeytettiin ${MAX_PAGES} sivun jälkeen` });
+            }
+            catch (e) {
+                findings.push({ id: "TOOLS_LIST_FAILED", severity: "error", message: `tools/list epäonnistui: ${errText(e)}` });
+            }
+            if (tools.length === 0 && !findings.some((f) => f.id === "TOOLS_LIST_FAILED")) {
+                findings.push({ id: "TOOLS_EMPTY", severity: "warning", message: "palvelin ilmoittaa tools-kyvyn mutta työkalulista on tyhjä" });
+            }
+            findings.push(...lintTools(tools));
+        }
+        const byName = new Map(tools.map((t) => [t.name, t]));
+        for (const call of opts.smoke ?? []) {
+            const tool = byName.get(call.tool);
+            if (!tool) {
+                findings.push({ id: "SMOKE_TOOL_NOT_FOUND", severity: "error", tool: call.tool, message: "savuajotiedostossa nimetty työkalu ei ole palvelimen listalla" });
+                smokeResults.push({ tool: call.tool, ok: false, ms: 0 });
+                continue;
+            }
+            const start = Date.now();
+            let ok = true;
+            const fail = (id, severity, message) => {
+                findings.push({ id, severity, tool: call.tool, message });
+                if (severity === "error")
+                    ok = false;
+            };
+            try {
+                const res = await client.callTool({ name: call.tool, arguments: call.arguments }, undefined, { timeout: opts.timeoutMs });
+                const ms = Date.now() - start;
+                const isError = res.isError === true;
+                if (isError && !call.expectError)
+                    fail("SMOKE_TOOL_ERROR", "error", `työkalu palautti virheen: ${firstText(res.content) || "(ei tekstiä)"}`);
+                else if (!isError && call.expectError)
+                    fail("SMOKE_EXPECTED_ERROR", "error", "työkalun odotettiin palauttavan virheen, mutta kutsu onnistui");
+                if (!isError) {
+                    const hasContent = Array.isArray(res.content) && res.content.length > 0;
+                    if (!hasContent && res.structuredContent === undefined)
+                        fail("SMOKE_EMPTY_RESULT", "warning", "työkalu palautti tyhjän tuloksen");
+                }
+                if (ms > call.maxMs)
+                    fail("SMOKE_SLOW", "warning", `vastaus kesti ${ms} ms (raja ${call.maxMs} ms)`);
+                smokeResults.push({ tool: call.tool, ok, ms });
+            }
+            catch (e) {
+                fail("SMOKE_CALL_FAILED", "error", `kutsu epäonnistui: ${errText(e)}`);
+                smokeResults.push({ tool: call.tool, ok: false, ms: Date.now() - start });
+            }
+        }
+        return build(opts, server, tools.length, findings, smokeResults);
+    }
+    finally {
+        await client.close().catch(() => undefined);
+    }
+}
+//# sourceMappingURL=runner.js.map

package/dist/runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.js","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"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"}

package/dist/smoke.js

@@ -0,0 +1,44 @@
+import { UsageError } from "./types.js";
+export const DEFAULT_MAX_MS = 5000;
+function isRecord(v) {
+    return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+/**
+ * Savuajotiedosto: {"calls": [{"tool": "nimi", "arguments": {...}, "expectError": false, "maxMs": 5000}]}
+ * (tai pelkkä taulukko). Vain tiedostossa nimetyt työkalut kutsutaan, mitään ei arvata.
+ */
+export function parseSmokeSpec(text) {
+    let data;
+    try {
+        data = JSON.parse(text);
+    }
+    catch {
+        throw new UsageError("Savuajotiedosto ei ole kelvollista JSONia");
+    }
+    const calls = Array.isArray(data) ? data : isRecord(data) ? data.calls : undefined;
+    if (!Array.isArray(calls))
+        throw new UsageError('Savuajotiedoston pitää olla taulukko tai {"calls": [...]}');
+    const out = [];
+    calls.forEach((c, i) => {
+        const at = `calls[${i}]`;
+        if (!isRecord(c))
+            throw new UsageError(`${at}: pitää olla objekti`);
+        if (typeof c.tool !== "string" || c.tool === "")
+            throw new UsageError(`${at}: tool puuttuu`);
+        if (c.arguments !== undefined && !isRecord(c.arguments))
+            throw new UsageError(`${at}: arguments pitää olla objekti`);
+        if (c.expectError !== undefined && typeof c.expectError !== "boolean")
+            throw new UsageError(`${at}: expectError pitää olla true tai false`);
+        if (c.maxMs !== undefined && !(typeof c.maxMs === "number" && Number.isFinite(c.maxMs) && c.maxMs > 0)) {
+            throw new UsageError(`${at}: maxMs pitää olla positiivinen luku`);
+        }
+        out.push({
+            tool: c.tool,
+            arguments: c.arguments ?? {},
+            expectError: c.expectError === true,
+            maxMs: c.maxMs ?? DEFAULT_MAX_MS,
+        });
+    });
+    return out;
+}
+//# sourceMappingURL=smoke.js.map

package/dist/smoke.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smoke.js","sourceRoot":"","sources":["../src/smoke.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAkB,MAAM,YAAY,CAAC;AAExD,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,CAAC;AAEnC,SAAS,QAAQ,CAAC,CAAU;IAC1B,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAClE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,IAAI,IAAa,CAAC;IAClB,IAAI,CAAC;QACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,UAAU,CAAC,2CAA2C,CAAC,CAAC;IACpE,CAAC;IACD,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IACnF,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,2DAA2D,CAAC,CAAC;IAC7G,MAAM,GAAG,GAAgB,EAAE,CAAC;IAC5B,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACrB,MAAM,EAAE,GAAG,SAAS,CAAC,GAAG,CAAC;QACzB,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;YAAE,MAAM,IAAI,UAAU,CAAC,GAAG,EAAE,sBAAsB,CAAC,CAAC;QACpE,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,KAAK,EAAE;YAAE,MAAM,IAAI,UAAU,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC;QAC7F,IAAI,CAAC,CAAC,SAAS,KAAK,SAAS,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;YAAE,MAAM,IAAI,UAAU,CAAC,GAAG,EAAE,gCAAgC,CAAC,CAAC;QACrH,IAAI,CAAC,CAAC,WAAW,KAAK,SAAS,IAAI,OAAO,CAAC,CAAC,WAAW,KAAK,SAAS;YAAE,MAAM,IAAI,UAAU,CAAC,GAAG,EAAE,yCAAyC,CAAC,CAAC;QAC5I,IAAI,CAAC,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,EAAE,CAAC;YACvG,MAAM,IAAI,UAAU,CAAC,GAAG,EAAE,sCAAsC,CAAC,CAAC;QACpE,CAAC;QACD,GAAG,CAAC,IAAI,CAAC;YACP,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,SAAS,EAAG,CAAC,CAAC,SAAiD,IAAI,EAAE;YACrE,WAAW,EAAE,CAAC,CAAC,WAAW,KAAK,IAAI;YACnC,KAAK,EAAG,CAAC,CAAC,KAA4B,IAAI,cAAc;SACzD,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IACH,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/types.js

@@ -0,0 +1,4 @@
+/** Käyttövirhe (väärä valitsin, rikkinäinen tiedosto): CLI palauttaa exit-koodin 2. */
+export class UsageError extends Error {
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AA4CA,uFAAuF;AACvF,MAAM,OAAO,UAAW,SAAQ,KAAK;CAAG"}

package/dist/versio.js

@@ -0,0 +1,5 @@
+import { createRequire } from "node:module";
+const vaatii = createRequire(import.meta.url);
+/** Paketin versio luetaan package.json:sta, ei kovakoodata (sama polku src/- ja dist/-hakemistosta). */
+export const VERSIO = vaatii("../package.json").version;
+//# sourceMappingURL=versio.js.map

package/dist/versio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"versio.js","sourceRoot":"","sources":["../src/versio.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;AAE9C,wGAAwG;AACxG,MAAM,CAAC,MAAM,MAAM,GAAY,MAAM,CAAC,iBAAiB,CAAyB,CAAC,OAAO,CAAC"}

package/package.json

@@ -1,6 +1,53 @@
-{
-  "name": "@tonyweckstrom/mcp-doctor",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+{
+  "name": "@tonyweckstrom/mcp-doctor",
+  "version": "0.2.0",
+  "description": "Terveystarkastus MCP-palvelimelle: initialize-kättely, työkalujen skeemojen tarkistus ja savuajo, raportti ja exit-koodi CI:lle. / Health check for MCP servers: handshake, tool schema lint and smoke calls, with a CI-friendly exit code.",
+  "license": "MIT",
+  "author": "Tony Weckström",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tonyweckstrom1987/mcp-doctor.git"
+  },
+  "homepage": "https://github.com/tonyweckstrom1987/mcp-doctor#readme",
+  "bugs": {
+    "url": "https://github.com/tonyweckstrom1987/mcp-doctor/issues"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "health-check",
+    "lint",
+    "ci",
+    "github-action"
+  ],
+  "type": "module",
+  "engines": {
+    "node": "^22.12.0 || ^24.0.0"
+  },
+  "bin": {
+    "mcp-doctor": "dist/bin.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepare": "npm run build",
+    "test": "vitest run",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "prepublishOnly": "npm run typecheck && npm test"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.30.1"
+  },
+  "devDependencies": {
+    "@types/node": "^26.6.5",
+    "typescript": "^7.0.2",
+    "vite": "^8.3.4",
+    "vitest": "^5.0.4",
+    "zod": "^4.6.6"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}