@k08200/mcp-probe 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 k08200
+
+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

@@ -0,0 +1,144 @@
+# mcp-probe
+
+[![CI](https://github.com/k08200/mcp-probe/actions/workflows/ci.yml/badge.svg)](https://github.com/k08200/mcp-probe/actions/workflows/ci.yml)
+[![npm](https://img.shields.io/npm/v/mcp-probe)](https://www.npmjs.com/package/mcp-probe)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Node.js](https://img.shields.io/node/v/mcp-probe)](package.json)
+
+**Quality checker for MCP servers.** Validates protocol handshake, tool discovery, and response latency in one command.
+
+The `npm audit` for the [MCP](https://modelcontextprotocol.io) ecosystem — because [awesome-mcp-servers](https://github.com/punkpeye/awesome-mcp-servers) lists 200+ servers and there was no way to know if they actually worked.
+
+```bash
+npx @k08200/mcp-probe @modelcontextprotocol/server-memory
+```
+
+```
+mcp-probe  @modelcontextprotocol/server-memory
+────────────────────────────────────────────────────
+  ✓  Target resolution
+     npx --yes @modelcontextprotocol/server-memory
+  ✓  MCP protocol handshake  1392ms
+     memory-server v0.6.3
+  ✓  Tools discovery  33ms
+     Found 9 tools
+  ✓  Tool schema validation
+     All tool schemas are valid
+────────────────────────────────────────────────────
+  Server   memory-server v0.6.3
+  Caps     tools
+
+  Tools
+    ▸ create_entities  Create multiple new entities in the knowledge graph
+    ▸ create_relations  Create multiple new relations between entities
+    ▸ add_observations  Add new observations to existing entities
+    ▸ delete_entities  Delete entities and their associated relations
+    ▸ read_graph  Read the entire knowledge graph
+    ▸ search_nodes  Search for nodes in the knowledge graph
+    ▸ ...and 3 more
+
+  ✓  PASS  1455ms total
+```
+
+---
+
+## Install
+
+```bash
+# No install needed
+npx @k08200/mcp-probe <target>
+
+# Or install globally
+npm install -g @k08200/mcp-probe
+```
+
+## Usage
+
+```bash
+# Check an npm package
+mcp-probe @modelcontextprotocol/server-memory
+
+# Check a server that requires arguments (e.g. directories to serve)
+mcp-probe @modelcontextprotocol/server-filesystem /tmp /Users/me/projects
+
+# Check a local server file
+mcp-probe ./my-server.js
+
+# JSON output for CI / scripting
+mcp-probe @scope/server --output json
+
+# Custom timeout (default: 10000ms)
+mcp-probe @scope/server --timeout 30000
+```
+
+## What it checks
+
+| Check | Description |
+|-------|-------------|
+| **Target resolution** | Can the package be located and spawned? |
+| **MCP protocol handshake** | Does the server respond to `initialize`? Measures connect latency. |
+| **Tools discovery** | Does `tools/list` return results? Measures list latency. |
+| **Tool schema validation** | Are all tool schemas well-formed? |
+
+## Exit codes
+
+| Code | Meaning |
+|------|---------|
+| `0` | All checks passed (or warnings only) |
+| `1` | One or more checks failed |
+
+## CI integration
+
+```yaml
+# .github/workflows/mcp-probe.yml
+- name: Validate MCP server
+  run: npx @k08200/mcp-probe @your-org/your-mcp-server
+  timeout-minutes: 2
+```
+
+## JSON output
+
+```bash
+mcp-probe @modelcontextprotocol/server-memory --output json
+```
+
+```json
+{
+  "target": "@modelcontextprotocol/server-memory",
+  "timestamp": "2026-05-17T12:00:00.000Z",
+  "overallStatus": "pass",
+  "checks": [
+    { "name": "Target resolution", "status": "pass", "message": "npx --yes @modelcontextprotocol/server-memory" },
+    { "name": "MCP protocol handshake", "status": "pass", "message": "memory-server v0.6.3", "latencyMs": 1392 },
+    { "name": "Tools discovery", "status": "pass", "message": "Found 9 tools", "latencyMs": 33 },
+    { "name": "Tool schema validation", "status": "pass", "message": "All tool schemas are valid" }
+  ],
+  "serverInfo": { "name": "memory-server", "version": "0.6.3", "capabilities": ["tools"] },
+  "tools": [{ "name": "create_entities", "description": "Create multiple new entities in the knowledge graph" }],
+  "totalLatencyMs": 1455
+}
+```
+
+## Status values
+
+| Status | Icon | Meaning |
+|--------|------|---------|
+| `pass` | ✓ | Check succeeded |
+| `warn` | ⚠ | Non-fatal issue (e.g. no tools registered) |
+| `fail` | ✗ | Check failed — exits with code 1 |
+
+## Roadmap
+
+- [ ] `resources/list` and `prompts/list` checks
+- [ ] HTTP/SSE transport support
+- [ ] Batch checking from a file (`mcp-probe --list servers.txt`)
+- [ ] Badge generation (`mcp-probe --badge > badge.json`)
+- [ ] Weekly quality report for awesome-mcp-servers
+
+## Contributing
+
+Issues and PRs are welcome. See [CONTRIBUTING.md](CONTRIBUTING.md).
+
+## License
+
+[MIT](LICENSE)

package/dist/checker.d.ts

@@ -0,0 +1,13 @@
+import type { CheckReport } from './types.js';
+type CheckOptions = {
+    target: string;
+    serverArgs?: string[];
+    timeoutMs: number;
+};
+export declare function resolveTarget(target: string): {
+    command: string;
+    args: string[];
+};
+export declare function checkMcpServer(options: CheckOptions): Promise<CheckReport>;
+export {};
+//# sourceMappingURL=checker.d.ts.map

package/dist/checker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checker.d.ts","sourceRoot":"","sources":["../src/checker.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAa,WAAW,EAAe,MAAM,YAAY,CAAC;AAEtE,KAAK,YAAY,GAAG;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAKjF;AAQD,wBAAsB,cAAc,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CA4FhF"}

package/dist/checker.js

@@ -0,0 +1,100 @@
+import { probeMcpServer } from './protocols/mcp-client.js';
+export function resolveTarget(target) {
+    if (target.startsWith('.') || target.startsWith('/')) {
+        return { command: 'node', args: [target] };
+    }
+    return { command: 'npx', args: ['--yes', target] };
+}
+function deriveOverallStatus(checks) {
+    if (checks.some((c) => c.status === 'fail'))
+        return 'fail';
+    if (checks.some((c) => c.status === 'warn'))
+        return 'warn';
+    return 'pass';
+}
+export async function checkMcpServer(options) {
+    const startTime = Date.now();
+    const checks = [];
+    const resolved = resolveTarget(options.target);
+    const args = [...resolved.args, ...(options.serverArgs ?? [])];
+    const { command } = resolved;
+    checks.push({
+        name: 'Target resolution',
+        status: 'pass',
+        message: `${command} ${args.join(' ')}`,
+    });
+    try {
+        const probe = await probeMcpServer({ command, args, timeoutMs: options.timeoutMs });
+        checks.push({
+            name: 'MCP protocol handshake',
+            status: 'pass',
+            message: `${probe.serverInfo.name} v${probe.serverInfo.version}`,
+            latencyMs: probe.connectLatencyMs,
+        });
+        const toolsStatus = probe.tools.length > 0 ? 'pass' : 'warn';
+        checks.push({
+            name: 'Tools discovery',
+            status: toolsStatus,
+            message: probe.tools.length > 0
+                ? `Found ${probe.tools.length} tool${probe.tools.length !== 1 ? 's' : ''}`
+                : 'No tools registered — server may be resources/prompts-only',
+            latencyMs: probe.toolsLatencyMs,
+        });
+        const toolsMissingName = probe.tools.filter((t) => !t.name);
+        if (probe.tools.length > 0) {
+            checks.push({
+                name: 'Tool schema validation',
+                status: toolsMissingName.length > 0 ? 'warn' : 'pass',
+                message: toolsMissingName.length > 0
+                    ? `${toolsMissingName.length} tool(s) missing required name field`
+                    : 'All tool schemas are valid',
+            });
+        }
+        if (probe.resources.length > 0 || probe.resourcesLatencyMs !== undefined) {
+            checks.push({
+                name: 'Resources discovery',
+                status: 'pass',
+                message: `Found ${probe.resources.length} resource${probe.resources.length !== 1 ? 's' : ''}`,
+                latencyMs: probe.resourcesLatencyMs,
+            });
+        }
+        if (probe.prompts.length > 0 || probe.promptsLatencyMs !== undefined) {
+            checks.push({
+                name: 'Prompts discovery',
+                status: 'pass',
+                message: `Found ${probe.prompts.length} prompt${probe.prompts.length !== 1 ? 's' : ''}`,
+                latencyMs: probe.promptsLatencyMs,
+            });
+        }
+        return {
+            target: options.target,
+            timestamp: new Date().toISOString(),
+            overallStatus: deriveOverallStatus(checks),
+            checks,
+            serverInfo: probe.serverInfo,
+            tools: probe.tools,
+            resources: probe.resources,
+            prompts: probe.prompts,
+            totalLatencyMs: Date.now() - startTime,
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        checks.push({
+            name: 'MCP protocol handshake',
+            status: 'fail',
+            message,
+        });
+        return {
+            target: options.target,
+            timestamp: new Date().toISOString(),
+            overallStatus: 'fail',
+            checks,
+            tools: [],
+            resources: [],
+            prompts: [],
+            totalLatencyMs: Date.now() - startTime,
+        };
+    }
+}
+//# sourceMappingURL=checker.js.map

package/dist/checker.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,38 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import ora from 'ora';
+import { checkMcpServer } from './checker.js';
+import { renderTerminal } from './reporters/terminal.js';
+import { renderJson } from './reporters/json-reporter.js';
+const program = new Command();
+program
+    .name('mcp-probe')
+    .description('Quality checker for MCP servers')
+    .version('0.1.0')
+    .argument('<target>', 'npm package, npx-style command, or local file path')
+    .argument('[server-args...]', 'extra arguments passed directly to the MCP server')
+    .option('-o, --output <format>', 'output format: terminal | json', 'terminal')
+    .option('-t, --timeout <ms>', 'connection timeout in ms', '10000')
+    .action(async (target, serverArgs, opts) => {
+    const timeoutMs = parseInt(opts.timeout, 10);
+    if (opts.output === 'json') {
+        const report = await checkMcpServer({ target, serverArgs, timeoutMs });
+        renderJson(report);
+        process.exit(report.overallStatus === 'fail' ? 1 : 0);
+        return;
+    }
+    const spinner = ora(`Checking ${target}`).start();
+    try {
+        const report = await checkMcpServer({ target, serverArgs, timeoutMs });
+        spinner.stop();
+        renderTerminal(report);
+        process.exit(report.overallStatus === 'fail' ? 1 : 0);
+    }
+    catch (err) {
+        spinner.fail('Unexpected error');
+        console.error(err instanceof Error ? err.message : String(err));
+        process.exit(1);
+    }
+});
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,GAAG,MAAM,KAAK,CAAC;AACtB,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAE1D,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,WAAW,CAAC;KACjB,WAAW,CAAC,iCAAiC,CAAC;KAC9C,OAAO,CAAC,OAAO,CAAC;KAChB,QAAQ,CAAC,UAAU,EAAE,oDAAoD,CAAC;KAC1E,QAAQ,CAAC,kBAAkB,EAAE,mDAAmD,CAAC;KACjF,MAAM,CAAC,uBAAuB,EAAE,gCAAgC,EAAE,UAAU,CAAC;KAC7E,MAAM,CAAC,oBAAoB,EAAE,0BAA0B,EAAE,OAAO,CAAC;KACjE,MAAM,CAAC,KAAK,EACX,MAAc,EACd,UAAoB,EACpB,IAAyC,EACzC,EAAE;IACF,MAAM,SAAS,GAAG,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAE7C,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,CAAC;QACvE,UAAU,CAAC,MAAM,CAAC,CAAC;QACnB,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACtD,OAAO;IACT,CAAC;IAED,MAAM,OAAO,GAAG,GAAG,CAAC,YAAY,MAAM,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;IAClD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,CAAC;QACvE,OAAO,CAAC,IAAI,EAAE,CAAC;QACf,cAAc,CAAC,MAAM,CAAC,CAAC;QACvB,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACxD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QACjC,OAAO,CAAC,KAAK,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAChE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/protocols/mcp-client.d.ts

@@ -0,0 +1,3 @@
+import type { ProbeOptions, ProbeResult } from '../types.js';
+export declare function probeMcpServer(options: ProbeOptions): Promise<ProbeResult>;
+//# sourceMappingURL=mcp-client.d.ts.map

package/dist/protocols/mcp-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-client.d.ts","sourceRoot":"","sources":["../../src/protocols/mcp-client.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAoB7D,wBAAsB,cAAc,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAiFhF"}

package/dist/protocols/mcp-client.js

@@ -0,0 +1,87 @@
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
+function firstMeaningfulLine(text) {
+    const lines = text.split('\n').map((l) => l.trim()).filter(Boolean);
+    // 1. "Error: ..." lines are most informative
+    const errorColonLine = lines.find((l) => /^Error:/.test(l));
+    if (errorColonLine)
+        return errorColonLine;
+    // 2. Skip stack frames, node internals, carets, and bare code fragments
+    const skip = /^at |^node:|^\^$|^const |^throw |^Require stack/;
+    const meaningful = lines.find((l) => !skip.test(l) && l.length > 3);
+    return meaningful ?? lines[0] ?? text;
+}
+function withTimeout(promise, ms, label) {
+    const timeout = new Promise((_, reject) => setTimeout(() => reject(new Error(`${label} timed out after ${ms}ms`)), ms));
+    return Promise.race([promise, timeout]);
+}
+export async function probeMcpServer(options) {
+    const transport = new StdioClientTransport({
+        command: options.command,
+        args: options.args,
+        env: { ...process.env },
+        stderr: 'pipe',
+    });
+    // Collect stderr so we can surface crash reasons in error messages
+    const stderrChunks = [];
+    transport.stderr?.on('data', (chunk) => stderrChunks.push(chunk));
+    const client = new Client({ name: 'mcp-probe', version: '0.1.0' }, { capabilities: { roots: { listChanged: false } } });
+    const connectStart = Date.now();
+    try {
+        await withTimeout(client.connect(transport), options.timeoutMs, 'Connection');
+    }
+    catch (err) {
+        const stderrText = Buffer.concat(stderrChunks).toString('utf8').trim();
+        const reason = stderrText
+            ? firstMeaningfulLine(stderrText)
+            : err instanceof Error ? err.message : String(err);
+        throw new Error(reason);
+    }
+    const connectLatencyMs = Date.now() - connectStart;
+    const rawServerInfo = client.getServerVersion();
+    const rawCaps = client.getServerCapabilities();
+    const capabilities = Object.keys(rawCaps ?? {});
+    const toolsStart = Date.now();
+    const toolsResult = await withTimeout(client.listTools(), options.timeoutMs, 'tools/list');
+    const toolsLatencyMs = Date.now() - toolsStart;
+    let resourcesLatencyMs;
+    let promptsLatencyMs;
+    const resourcesList = [];
+    const promptsList = [];
+    if (rawCaps?.resources) {
+        const t = Date.now();
+        const result = await withTimeout(client.listResources(), options.timeoutMs, 'resources/list');
+        resourcesLatencyMs = Date.now() - t;
+        for (const r of result.resources) {
+            resourcesList.push({ uri: r.uri, name: r.name, description: r.description });
+        }
+    }
+    if (rawCaps?.prompts) {
+        const t = Date.now();
+        const result = await withTimeout(client.listPrompts(), options.timeoutMs, 'prompts/list');
+        promptsLatencyMs = Date.now() - t;
+        for (const p of result.prompts) {
+            promptsList.push({ name: p.name, description: p.description });
+        }
+    }
+    await client.close();
+    return {
+        serverInfo: {
+            name: rawServerInfo?.name ?? 'unknown',
+            version: rawServerInfo?.version ?? 'unknown',
+            capabilities,
+        },
+        tools: toolsResult.tools.map((t) => ({
+            name: t.name,
+            description: t.description,
+            inputSchema: t.inputSchema,
+        })),
+        resources: resourcesList,
+        prompts: promptsList,
+        connectLatencyMs,
+        toolsLatencyMs,
+        resourcesLatencyMs,
+        promptsLatencyMs,
+    };
+}
+//# sourceMappingURL=mcp-client.js.map

package/dist/protocols/mcp-client.js.map

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

package/dist/reporters/json-reporter.d.ts

@@ -0,0 +1,3 @@
+import type { CheckReport } from '../types.js';
+export declare function renderJson(report: CheckReport): void;
+//# sourceMappingURL=json-reporter.d.ts.map

package/dist/reporters/json-reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-reporter.d.ts","sourceRoot":"","sources":["../../src/reporters/json-reporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,wBAAgB,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAEpD"}

package/dist/reporters/json-reporter.js

@@ -0,0 +1,4 @@
+export function renderJson(report) {
+    process.stdout.write(JSON.stringify(report, null, 2) + '\n');
+}
+//# sourceMappingURL=json-reporter.js.map

package/dist/reporters/json-reporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-reporter.js","sourceRoot":"","sources":["../../src/reporters/json-reporter.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,UAAU,CAAC,MAAmB;IAC5C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AAC/D,CAAC"}

package/dist/reporters/terminal.d.ts

@@ -0,0 +1,3 @@
+import type { CheckReport } from '../types.js';
+export declare function renderTerminal(report: CheckReport): void;
+//# sourceMappingURL=terminal.d.ts.map

package/dist/reporters/terminal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.d.ts","sourceRoot":"","sources":["../../src/reporters/terminal.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAe,MAAM,aAAa,CAAC;AAgB5D,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAyDxD"}

package/dist/reporters/terminal.js

@@ -0,0 +1,64 @@
+import chalk from 'chalk';
+const ICONS = {
+    pass: chalk.green('✓'),
+    fail: chalk.red('✗'),
+    warn: chalk.yellow('⚠'),
+};
+const COLORS = {
+    pass: chalk.green,
+    fail: chalk.red,
+    warn: chalk.yellow,
+};
+const DIVIDER = chalk.dim('─'.repeat(52));
+export function renderTerminal(report) {
+    console.log('');
+    console.log(chalk.bold.white('mcp-probe') + '  ' + chalk.dim(report.target));
+    console.log(DIVIDER);
+    for (const check of report.checks) {
+        const latency = check.latencyMs !== undefined
+            ? chalk.dim(` ${check.latencyMs}ms`)
+            : '';
+        console.log(`  ${ICONS[check.status]}  ${chalk.bold(check.name)}${latency}`);
+        console.log(`     ${chalk.dim(check.message)}`);
+    }
+    console.log(DIVIDER);
+    if (report.serverInfo) {
+        const { name, version, capabilities } = report.serverInfo;
+        console.log(chalk.dim(`  Server   ${name} v${version}`));
+        if (capabilities.length > 0) {
+            console.log(chalk.dim(`  Caps     ${capabilities.join(', ')}`));
+        }
+    }
+    if (report.tools.length > 0) {
+        console.log('');
+        console.log(chalk.bold('  Tools'));
+        for (const tool of report.tools) {
+            const desc = tool.description ? chalk.dim(`  ${tool.description}`) : '';
+            console.log(`    ${chalk.cyan('▸')} ${chalk.bold(tool.name)}${desc}`);
+        }
+    }
+    if (report.resources.length > 0) {
+        console.log('');
+        console.log(chalk.bold('  Resources'));
+        for (const res of report.resources) {
+            const label = res.name ?? res.uri;
+            const desc = res.description ? chalk.dim(`  ${res.description}`) : '';
+            console.log(`    ${chalk.magenta('▸')} ${chalk.bold(label)}${desc}`);
+        }
+    }
+    if (report.prompts.length > 0) {
+        console.log('');
+        console.log(chalk.bold('  Prompts'));
+        for (const prompt of report.prompts) {
+            const desc = prompt.description ? chalk.dim(`  ${prompt.description}`) : '';
+            console.log(`    ${chalk.yellow('▸')} ${chalk.bold(prompt.name)}${desc}`);
+        }
+    }
+    console.log('');
+    const status = report.overallStatus;
+    const label = COLORS[status](chalk.bold(status.toUpperCase()));
+    const total = chalk.dim(`  ${report.totalLatencyMs}ms total`);
+    console.log(`  ${ICONS[status]}  ${label}${total}`);
+    console.log('');
+}
+//# sourceMappingURL=terminal.js.map

package/dist/reporters/terminal.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,53 @@
+export type CheckStatus = 'pass' | 'fail' | 'warn';
+export type CheckItem = {
+    name: string;
+    status: CheckStatus;
+    message: string;
+    latencyMs?: number;
+};
+export type ToolInfo = {
+    name: string;
+    description?: string;
+    inputSchema?: unknown;
+};
+export type ServerInfo = {
+    name: string;
+    version: string;
+    capabilities: string[];
+};
+export type CheckReport = {
+    target: string;
+    timestamp: string;
+    overallStatus: CheckStatus;
+    checks: CheckItem[];
+    serverInfo?: ServerInfo;
+    tools: ToolInfo[];
+    resources: ResourceInfo[];
+    prompts: PromptInfo[];
+    totalLatencyMs: number;
+};
+export type ResourceInfo = {
+    uri: string;
+    name?: string;
+    description?: string;
+};
+export type PromptInfo = {
+    name: string;
+    description?: string;
+};
+export type ProbeResult = {
+    serverInfo: ServerInfo;
+    tools: ToolInfo[];
+    resources: ResourceInfo[];
+    prompts: PromptInfo[];
+    connectLatencyMs: number;
+    toolsLatencyMs: number;
+    resourcesLatencyMs?: number;
+    promptsLatencyMs?: number;
+};
+export type ProbeOptions = {
+    command: string;
+    args: string[];
+    timeoutMs: number;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAEnD,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,WAAW,CAAC;IAC3B,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,UAAU,EAAE,UAAU,CAAC;IACvB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@k08200/mcp-probe",
+  "version": "0.1.0",
+  "description": "Quality checker for MCP servers — validates protocol handshake, tool discovery, and response latency",
+  "type": "module",
+  "bin": {
+    "mcp-probe": "dist/cli.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/cli.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "ai",
+    "llm",
+    "cli",
+    "testing",
+    "validation",
+    "inspector",
+    "checker"
+  ],
+  "author": "k08200",
+  "license": "MIT",
+  "homepage": "https://github.com/k08200/mcp-probe#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/k08200/mcp-probe.git"
+  },
+  "bugs": {
+    "url": "https://github.com/k08200/mcp-probe/issues"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "ora": "^8.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@vitest/coverage-v8": "^2.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.6.0",
+    "vitest": "^2.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}