{"repo":"genesiscode2026/genesis-mcp-quick-readiness-scan","private":true,"description":null,"default_branch":"main","stars":0,"forks":0,"pushed_at":"2026-09-17T10:23:34Z","languages":{"JavaScript":7406},"files":12,"tree":[".gitignore","CHANGELOG.md","LICENSE","QUICKSTART.md","README.md","SECURITY.md","VERSION","bin/genesis-mcp-quick-scan.js","package.json","src/scanner.js","tests/fixtures/mock_mcp_server.js","tests/test_scanner.js"],"sizes":{".gitignore":103,"CHANGELOG.md":581,"LICENSE":1072,"QUICKSTART.md":399,"README.md":2221,"SECURITY.md":281,"VERSION":6,"bin/genesis-mcp-quick-scan.js":2862,"package.json":554,"src/scanner.js":3595,"tests/fixtures/mock_mcp_server.js":1068,"tests/test_scanner.js":949},"readme":"# genesis-mcp-quick-readiness-scan\n\n> **5-second Model Context Protocol readiness smoke tester and tool contract scanner.**\n\n[![Version](https://img.shields.io/badge/version-1.0.0-blue.svg)](VERSION)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n[![Zero Dependencies](https://img.shields.io/badge/dependencies-0-brightgreen.svg)](package.json)\n\n---\n\n## The Problem\n\nWhen configuring local MCP servers or integrating third-party tool bundles, debugging startup failures is painful:\n- Servers hang on stdio without sending proper initialization responses.\n- Tool schemas contain missing parameters or malformed types that cause Claude Desktop or Cursor to reject the server silently.\n- Engineers have to write custom JSON-RPC harness scripts just to verify if an MCP server runs.\n\n## The Solution\n\n`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.\n\n---\n\n## Key Features\n\n- **Zero Third-Party Dependencies**: Pure Node.js standard library (v18+).\n- **Fast Protocol Handshake**: Executes `initialize` and protocol version negotiation in <50ms.\n- **Input Schema Auditor**: Validates that all tool `inputSchema` definitions conform to standard JSON Schema object types.\n- **Watchdog Timeout**: Enforces a 5-second hard execution timeout to detect hanging servers.\n- **CI / Docker Ready**: Returns exit code 0 on `READY`, exit code 1 on failure.\n\n---\n\n## Quickstart\n\n```bash\n# Clone the repository\ngit clone git@github.com:genesiscode2026/genesis-mcp-quick-readiness-scan.git\ncd genesis-mcp-quick-readiness-scan\n\n# Scan any local MCP server\n./bin/genesis-mcp-quick-scan.js --cmd node --args ./path/to/server.js\n\n# Output machine-readable JSON\n./bin/genesis-mcp-quick-scan.js --cmd python3 --args -m,my_mcp_server --json\n```\n\n---\n\n## Commercial Distribution\n\n- **Product Name**: `genesis-mcp-quick-readiness-scan`\n- **Catalog ID**: `E02`\n- **Price**: $19\n- **Seller**: `genesiscode2026`\n- **Authorized Payout Rail**: USDC on Base (`0xC6F86e170411182114FcCdb28793dC76B5e8D144`)\n- **License**: MIT\n","price_usd":"19.00","clone_checkout":"https://api.checkout402.com/c/chk_afuk0hq0CcFPhnud","rehearse_checkout":"https://api.checkout402.com/c/chk_afuk0hq0CcFPhnud/test","preview":"/r/genesiscode2026/genesis-mcp-quick-readiness-scan/f/<path> serves file CONTENTS for the seller's preview paths; other paths answer with the price","how_to_buy":"pay clone_checkout with x402 (pay402 does it in one call); the goods arrive as payload_base64, a tar.gz of the full repo. Rehearse first at rehearse_checkout: same flow, simulated money.","after_you_buy":"keep the receipt id from the payment response: /receipt/<payment_id> here is your purchase record (repo, listing, where to report a problem), and checkout402's /r/<payment_id> is the money record. Tell your human both URLs."}