geniusmcp

<div align="center">

Quality-aware code intelligence that turns GitHub search into ranked, explainable, import-ready recommendations.

[](https://nodejs.org) [](#testing) [](LICENSE) [](https://modelcontextprotocol.io)

<br/>

Not another grep. An intelligence layer.

Quick Start · How It Works · Soul · Tools · Architecture

</div>

---

Every code search tool answers "where is this string?"

None of them answer "what is the _best_ implementation, why, and can I safely use it?"

When you ask genius.hunt("retry with backoff"), GeniusMCP returns:

Archetype 1 — Minimal inline helper
  ✅ 12 LOC, zero deps, copy-paste ready
  Exemplar: owner/repo — score 0.87 (battle_tested)
  Why: test-adjacent, MIT license, 3 years stable

Archetype 2 — Configurable utility
  ✅ Options-driven, max attempts + jitter strategy
  Exemplar: owner/repo2 — score 0.82
  Why: 14K stars, active maintenance, comprehensive docs

Archetype 3 — Middleware pattern
  ✅ Express/Fastify compatible, interceptor-based
  Exemplar: owner/repo3 — score 0.79
  Tradeoff: framework-coupled

Coverage: 3 sources searched, 2 blind spots, confidence: 0.83

That's the gap GeniusMCP fills.

---

| Feature | What it does | |---------|-------------| | 🎯 Archetype Search | Finds 3-5 structural families, not 200 raw matches | | 📊 6-Bucket Quality Scoring | queryFit · durability · vitality · importability · codeQuality · evidenceConfidence | | **🔍 Multi-Source