jubstaaa/hono-telescope

A debugging tool for Hono applications, inspired by Laravel Telescope: a dashboard that shows
you every request with the logs, queries, exceptions and outgoing calls that happened inside it.
**The same endpoint is also an MCP server.** Point Claude Code, Cursor or any MCP client at it
and your coding agent reads the running application's telemetry directly — the actual exception,
the request that produced it, and the queries that ran — instead of being handed a pasted stack
trace. Nothing else in the Hono ecosystem does that.
Zero runtime dependencies. Works on Node.js and Bun.
---
🌐 Live Demo
A hosted instance of the example app, running 1.0. No installation needed.
**📊 Open the dashboard** — API base: https://hono-telescope.ilkerbalcilar.com
Hit a few endpoints and watch the entries appear:
The demo runs with memoryStorage({ maxEntries: 500 }) and no dashboard auth, so entries are
public, capped at 500 and gone on restart. Don't send anything you wouldn't publish.
---
✨ Features
**Currently Available:**
- 📡 **MCP Server** - The dashboard endpoint doubles as a Model Context Protocol server, so an AI agent can read live requests, exceptions and queries with five read-only tools
- 🔍 **HTTP Request Monitoring** - Track incoming requests with headers, payloads and response bodies, and outgoing fetch calls with headers, payloads and responses
- 🚨 **Exception Tracking** - Capture and monitor application errors with stack traces
- 📝 **Log Monitoring** - Monitor console logs with different severity levels
- 🗄️ **Database Query Monitoring** - Explicit per-client instrumentation for Prisma, Sequelize, MongoDB, and Bun SQLite with execution time
- 📊 **Beautiful Dashboard** - Modern React-based web interface with real-time updates
- 🎯 **Zero Configuration** - Works out of the box with sensible defaults
- 🏷️ **Tagging System** - Organize entries with custom tags and context
- 🔧 **TypeScript Support** - Full type definitions and type safety
- ⚡ **High Performance** - Minimal overhead with efficient memory management
- 🌐 **Bun & Node.js** - Works with both runtimes seamlessly
- 🗂️ **Multiple Database Support** - Integrates with popular database libraries
- ⚙️ **Zero Runtime Dependencies** - Depends only on Hono (peer dependency)
**Planned Features (Roadmap):**
- 💾 **Data Export** - Export monitored data in multiple formats (JSON, CSV)
- 🔔 **Alerts & Notifications** - Real-time alerts for errors and performance issues
- 📈 **Analytics & Reporting** - Advanced analytics and historical data analysis
- 🔐 **Authentication & Authorization** - Dashboard access control beyond basic auth
- 🌍 **Multi-Tenancy Support** - Support for multiple isolated projects
- 🧩 **Plugin System** - Extensible plugin architecture for custom integrations
- 🔄 **Data Persistence** - Optional database storage for long-term monitoring
📦 Installation
Quick Start
Visit /telescope. Telescope is on by default outside production and off inside it.
> 📋 **Complete Example**: See src/example/index.ts for a full working example with all Telescope features including database query monitoring, external request tracking, and error handling.
MCP Server
Telescope's dashboard doubles as an MCP server, so an AI
coding agent can read the running application's telemetry instead of being handed pasted stack
traces. There is nothing extra to mount — it is served from the dashboard you already mounted:
| Tool | What it answers |
| ------------------- | -------------------------------------------------------------------------------------- |
| recent_exceptions | What just failed — each exception with its request and that request's logs and queries |
| recent_requests | Which requests ran; filter by minStatus, status, minDuration, uriContains |
| request_detail | One request in full, untruncated, with every child entry |
| slow_queries | The slowest recent queries and which request each ran in |