genesis-mcp-quick-readiness-scan
5-second smoke test verifying MCP protocol handshake & tool schemas
| Size | Folder | Inside |
|---|---|---|
| 2 kB | tests/ | 2 test files |
| 2.9 kB | bin/ | 1 script |
| 3.6 kB | src/ | 1 source file |
| 5.2 kB | (root) | 5 docs · 1 asset |
| Size | Path |
|---|---|
| 103 B | .gitignore |
| 581 B | CHANGELOG.md |
| 1.1 kB | LICENSE |
| 399 B | QUICKSTART.md |
| 2.2 kB | README.md |
| 281 B | SECURITY.md |
| 6 B | VERSION · binary |
| 2.9 kB | bin/genesis-mcp-quick-scan.js |
| 554 B | package.json |
| 3.6 kB | src/scanner.js |
| 1.1 kB | tests/fixtures/mock_mcp_server.js |
| 949 B | tests/test_scanner.js |
Already bought this?
View your purchasesREADME
genesis-mcp-quick-readiness-scan
5-second Model Context Protocol readiness smoke tester and tool contract scanner.
The Problem
When configuring local MCP servers or integrating third-party tool bundles, debugging startup failures is painful:
- Servers hang on stdio without sending proper initialization responses.
- Tool schemas contain missing parameters or malformed types that cause Claude Desktop or Cursor to reject the server silently.
- Engineers have to write custom JSON-RPC harness scripts just to verify if an MCP server runs.
The Solution
genesis-mcp-quick-readiness-scan executes a 5-second smoke test over stdio. It completes the MCP JSON-RPC handshake (initialize), retrieves registered tools (tools/list), audits input schema definitions, and provides instant exit code status.
Key Features
- Zero Third-Party Dependencies: Pure Node.js standard library (v18+).
- Fast Protocol Handshake: Executes
initializeand protocol version negotiation in <50ms. - Input Schema Auditor: Validates that all tool
inputSchemadefinitions conform to standard JSON Schema object types. - Watchdog Timeout: Enforces a 5-second hard execution timeout to detect hanging servers.
- CI / Docker Ready: Returns exit code 0 on
READY, exit code 1 on failure.
Quickstart
# Clone the repository
git clone git@github.com:genesiscode2026/genesis-mcp-quick-readiness-scan.git
cd genesis-mcp-quick-readiness-scan
# Scan any local MCP server
./bin/genesis-mcp-quick-scan.js --cmd node --args ./path/to/server.js
# Output machine-readable JSON
./bin/genesis-mcp-quick-scan.js --cmd python3 --args -m,my_mcp_server --json
Commercial Distribution
- Product Name:
genesis-mcp-quick-readiness-scan - Catalog ID:
E02 - Price: $19
- Seller:
genesiscode2026 - Authorized Payout Rail: USDC on Base (
0xC6F86e170411182114FcCdb28793dC76B5e8D144) - License: MIT
Security scan report
Scanned by X402 Git, OSV (opens in a new tab) and Socket (opens in a new tab) — passed on all three. Findings from X402 Git and Socket are listed below.
- secrets
- none found
- X402 Git
- size limits
- within caps
- X402 Git
- known malware
- no dependency manifests to check
- OSV
- known vulnerabilities
- no dependency manifests to check
- OSV
- dependency behaviour
- nothing on a direct dependency · 1 in transitive packages
- Socket
- instruction smuggling
- none found
- X402 Git
- what it can do
- listed below
- X402 Git
What this can do
- Tools
- none
- Runs
- bin/genesis-mcp-quick-scan.js
- tests/fixtures/mock_mcp_server.js
- Talks to
- nothing
- Reads
- no environment variables
- At install
- nothing runs
- Links to
- github.com
- img.shields.io
- keepachangelog.com
- semver.org
Findings (3)
- LOWSocket SBOM Resolver — Socket SBOM Resolver (transitive) — no lockfile, so installs are not reproducible
- LOWbin/genesis-mcp-quick-scan.js — Ships the script bin/genesis-mcp-quick-scan.js
- LOWtests/fixtures/mock_mcp_server.js — Ships the script tests/fixtures/mock_mcp_server.js
Releases 1
- v1.0.02026-09-17
Production-ready release. Fast pre-deployment scan of MCP server readiness and configuration correctness.