Skip to content
Back to search

jetski

Authentication, analytics, and prompt visibility for MCP servers with zero code changes. Supports OAuth2.1, DCR, real-time logs, and client onboarding out of the box

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/hyprmcp--jetski/badge.svg)](/listings/hyprmcp--jetski)

HTML

<a href="/listings/hyprmcp--jetski"><img src="/api/listings/hyprmcp--jetski/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

> [!TIP] > Get started with our fully managed HyprMCP Cloud at [https://app.hyprmcp.com](https://app.hyprmcp.com/).

HyprMCP uses [mise](https://mise.jdx.dev/) to configure your development environment and execute development tasks.

1. Jetski Analytics Platform

**Clone the repository:**

  git clone https://github.com/hyprmcp/jetski.git
  cd jetski

**Install dependencies:**

  mise trust
  mise install
  pnpm i
  cp .dex.secret.env.example .dex.secret.env
  docker compose up -d

**Set host file entry:**

  echo -e "\n127.0.0.1    host.minikube.internal\n" | sudo tee -a /etc/hosts

**Start the platform:**

In Terminal 1, start the backend:

  mise run serve

In Terminal 2, start the frontend:

  pnpm run start

Generate demo data:

  mise run generate

Access the frontend at `http://localhost:4200` and log in with: `admin@example.com` / `password`

2. Jetski MCP Gateway Orchestration (Optional)

For Kubernetes orchestration, we recommend [Minikube](https://minikube.sigs.k8s.io/docs/) for local testing.

**Setup Kubernetes:**

  # Start Minikube
  mise run minikube-start

  # Deploy metacontroller (⚠️ operates against current kubectl context)
  mise run serve -- --install-controller

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 243 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. [![GitHub Repo stars](https://img.shields.io/github/stars/hyprmcp/jetski?style=flat)](https://github.com/hyprmcp/jetski)
  2. [![License](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
  3. [![Docs](https://img.shields.io/badge/docs-hyprmcp.com%2Fdocs-blue)](https://hyprmcp.com/docs/getting-started/?utm_source=github)
  4. [![PRs](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)
  5. [![Discord](https://img.shields.io/badge/HyprMCP-Discord-%235865F2.svg)](https://discord.gg/CgZ775fcsy)
  6. [![Downloads](https://img.shields.io/github/downloads/hyprmcp/jetski/total)](https://github.com/hyprmcp/jetski/releases)
  7. [![Go Reference](https://pkg.go.dev/badge/github.com/hyprmcp/jetski)](https://pkg.go.dev/github.com/hyprmcp/jetski)
  8. [![Go Report Card](https://goreportcard.com/badge/github.com/hyprmcp/jetski)](https://goreportcard.com/report/github.com/hyprmcp/jetski)
  9. <br>
  10. <div align="center">
  11. <a href="https://hyprmcp.com?utm_source=github">
  12. <img src="./.readme/hyprmcp.webp" alt="HyprMCP Logo" height="160">
  13. </a>
  14. <h3 align="center">🚤 MCP Analytics and Authentication Platform 🔐</h3>
  15. <p align="center">
  16. <a href="https://app.hyprmcp.com/?utm_source=github"><strong>Get started with HyprMCP Cloud »</strong></a>
  17. <br> <br>
  18. <a href="https://hyprmcp.com/?utm_source=github"><strong>Explore our website »</strong></a>
  19. <br> <br>
  20. <a href="https://hyprmcp.com/docs/"><strong>Read the docs »</strong></a>
  21. <br> <br>
  22. <a href="https://github.com/hyprmcp" target="_blank">GitHub</a>
  23. .
  24. <a href="https://www.linkedin.com/company/glasskube/" target="_blank">LinkedIn</a>
  25. .
  26. <a href="https://x.com/intent/follow?screen_name=glasskube" target="_blank">Twitter / X</a>
  27. </p>
  28. </div>
  29. <hr>
  30. ## 🚤 What is Jetski?
  31. Jetski is an **Open Source MCP Analytics and Authentication Platform** - part of HyprMCP.
  32. It solves the three biggest problems teams face when developing MCP servers with **zero code changes**:
  33. 1. **Installation & Setup**: Most users never make it past setup. They can't find client instructions or try to open your MCP URL in a browser and churn immediately.
  34. 2. **Authentication**: Identifying users and giving them the right tools and responses is still painful to implement.
  35. 3. **Logs, Analytics & Visibility**: No insight into how your MCP is used, which prompts trigger which tools, or why errors happen.
  36. Our platform manages and deploys instances of our [`mcp-gateway`](https://github.com/hyprmcp/mcp-gateway) that **sits in front of your MCP server** and handles the complexity.
  37. It also collects and aggregates all analytics and metrics data captured by the gateway.
  38. > [!IMPORTANT]
  39. > Note that Jetski in under active development and is still in its infancy.
  40. > The APIs and command-line interface may change in a backwards incompatible manner.
  41. ## 🗄️ Table Of Contents
  42. - [What is Jetski?](https://github.com/hyprmcp/jetski#-what-is-jetski)
  43. - [Features](https://github.com/hyprmcp/jetski#-features)
  44. - [Quick Start](https://github.com/hyprmcp/jetski#-quick-start---get-started-in-minutes)
  45. - [Demo Video](https://github.com/hyprmcp/jetski#-hyprmcp-demo-video)
  46. - [HyprMCP Components](https://github.com/hyprmcp/jetski#-hyprmcp-components)
  47. - [Architecture Diagram](https://github.com/hyprmcp/jetski#architecture-diagram)
  48. - [Need Help?](https://github.com/hyprmcp/jetski#-need-help-or-want-to-provide-feedback)
  49. - [Used Projects](https://github.com/hyprmcp/jetski#-used-projects)
  50. - [How to Contribute](https://github.com/hyprmcp/jetski#-how-to-contribute-to-hyprmcp)
  51. - [Contributors](https://github.com/hyprmcp/jetski#-thanks-to-all-our-contributors)
  52. - [Activity](https://github.com/hyprmcp/jetski#-activity)
  53. - [License](https://github.com/hyprmcp/jetski#-license)
  54. ## ✨ Features
  55. | | |
  56. |---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------|
  57. | **Comprehensive Prompt Analytics** <br> See which prompts triggered which tools, from which clients, and what happened.<br>Gain complete visibility into your MCP server usage patterns and understand how users interact with your tools in real-time. | <img src=".readme/mcp-prompt-analytics.webp" alt="Prompt Analytics" style="width: 1000px"> |
  58. | **Auto-Generated Setup Instructions** <br> Help users connect to the client effortlessly.<br>We automatically generate clear, step-by-step instructions for every supported MCP client, eliminating the #1 reason users churn during onboarding. | <img src=".readme/mcp-instructions.webp" alt="Setup Instructions" style="width: 1000px"> |
  59. | **Zero-Code Authentication** <br> Identify and manage users securely without writing a single line of code.<br>Our proxy handles all authentication logic, allowing you to provide personalized tools and responses based on user identity. | <img src=".readme/mcp-authentication.webp" alt="Authentication" style="width: 1000px"> |
  60. | **Real-Time Debug Logs** <br> Instantly debug issues and understand server behavior in real-time.<br>See detailed logs of every request, response, and error, making it easy to identify and fix problems quickly. | <img src=".readme/mcp-logs.webp" alt="Debug Logs" style="width: 1000px"> |
  61. ## 🚀 Quick Start - Get Started in Minutes
  62. > [!TIP]
  63. > Get started with our fully managed HyprMCP Cloud at [https://app.hyprmcp.com](https://app.hyprmcp.com/).
  64. HyprMCP uses [mise](https://mise.jdx.dev/) to configure your development environment and execute development tasks.
  65. ### 1. Jetski Analytics Platform
  66. **Clone the repository:**
  67. ```bash
  68. git clone https://github.com/hyprmcp/jetski.git
  69. cd jetski
  70. ```
  71. **Install dependencies:**
  72. ```bash
  73. mise trust
  74. mise install
  75. pnpm i
  76. cp .dex.secret.env.example .dex.secret.env
  77. docker compose up -d
  78. ```
  79. **Set host file entry:**
  80. ```bash
  81. echo -e "\n127.0.0.1 host.minikube.internal\n" | sudo tee -a /etc/hosts
  82. ```
  83. **Start the platform:**
  84. In Terminal 1, start the backend:
  85. ```bash
  86. mise run serve
  87. ```
  88. In Terminal 2, start the frontend:
  89. ```bash
  90. pnpm run start
  91. ```
  92. Generate demo data:
  93. ```bash
  94. mise run generate
  95. ```
  96. Access the frontend at `http://localhost:4200` and log in with: `admin@example.com` / `password`
  97. ### 2. Jetski MCP Gateway Orchestration (Optional)
  98. For Kubernetes orchestration, we recommend [Minikube](https://minikube.sigs.k8s.io/docs/) for local testing.
  99. **Setup Kubernetes:**
  100. ```bash
  101. # Start Minikube
  102. mise run minikube-start
  103. # Deploy metacontroller (⚠️ operates against current kubectl context)
  104. mise run serve -- --install-controller
  105. ```
  106. ## 🎬 HyprMCP Demo Video
  107. [![HyprMCP Demo Video](https://i.ytimg.com/vi/m2-YyfjXap4/hq720.jpg)](https://www.youtube.com/watch?v=m2-YyfjXap4)
  108. ## 🎯 HyprMCP Components
  109. The HyprMCP platform is built on several open-source components that work together to provide a comprehensive MCP management solution:
  110. ### Core Components
  111. - **[mcp-gateway](https://github.com/hyprmcp/mcp-gateway)** - MCP OAuth Proxy with dynamic client registration (DCR), MCP prompt analytics. This proxy sits in front of your MCP server.
  112. - **[mcp-install-instructions-generator](https://github.com/hyprmcp/mcp-install-instructions-generator)** - Generate MCP Server Installation Instructions for Cursor, Visual Studio Code, Claude Code, and other MCP clients. Automatically creates user-friendly setup guides.
  113. You can find all our components and contribute to them on [github.com/hyprmcp](https://github.com/hyprmcp).
  114. ## Architecture Diagram
  115. ```mermaid
  116. graph LR
  117. Client([🤖 <b>MCP Client</b><br/>Claude, ChatGPT...<br/>.<br/>])
  118. subgraph K8s["☸️ HyprMCP"]
  119. direction TB
  120. Platform[🚤 <b>Jetski Platform</b><br/>Kubernetes Client, Dashboards, etc.<br/>.<br/>]
  121. Gateway[🔄 <b>MCP Gateway</b><br/>Auth, proxy, analytics & logging<br/>.<br/>]
  122. Platform-.deploys & manages.->Gateway
  123. Gateway-.sends metrics & logs.->Platform
  124. end
  125. MCP[🚀 <b>Your MCP Server</b><br/>Runs unchanged, anywhere]
  126. Client <--> K8s
  127. K8s <--> MCP
  128. classDef client fill:#fff9c4,stroke:#f57f17,stroke-width:2px
  129. classDef cluster fill:#e3f2fd,stroke:#1565c0,stroke-width:2px
  130. classDef platform fill:#f3e5f5,stroke:#4a148c,stroke-width:2px
  131. classDef server fill:#e8f5e8,stroke:#2e7d32,stroke-width:2px
  132. class Client client
  133. class K8s cluster
  134. class Platform,Gateway platform
  135. class MCP server
  136. ```
  137. **How it works:**
  138. 1. **MCP Client** (Claude Desktop, Cline, etc.) sends requests to HyprMCP instead of directly to your server
  139. 2. **HyprMCP Proxy** authenticates the user and validates permissions
  140. 3. **Request forwarding** to your unchanged MCP server
  141. 4. **Response handling** with automatic logging, analytics capture, and monitoring
  142. 5. **Real-time dashboard** provides visibility into all operations
  143. ## ☝️ Need Help or Want to Provide Feedback?
  144. If you encounter any problems, we will be happy to support you wherever we can on our [Discord](https://discord.gg/CgZ775fcsy).
  145. For bugs, issues or feature requests feel free to [open an issue](https://github.com/hyprmcp/jetski/issues/new/choose).
  146. We are happy to assist you with anything related to the project.
  147. ## 📎 Used Projects
  148. HyprMCP is built on top of many amazing open-source projects:
  149. ### Core Technologies
  150. - **[Go](https://github.com/golang/go)** - Primary backend language for the platform
  151. - **[Angular](https://github.com/angular/angular)** - Frontend framework for the dashboard UI
  152. - **[Kubernetes](https://github.com/kubernetes/kubernetes)** - Container orchestration platform
  153. - **[PostgreSQL](https://github.com/postgres/postgres)** - Primary database for storing analytics and metadata
  154. ### MCP & Authentication
  155. - **[MCP Go SDK](https://github.com/modelcontextprotocol/go-sdk)** - Official Go SDK for Model Context Protocol
  156. - **[Dex](https://github.com/dexidp/dex)** - OpenID Connect (OIDC) identity provider for authentication
  157. ### Kubernetes & Infrastructure
  158. - **[Metacontroller](https://github.com/metacontroller/metacontroller)** - Lightweight Kubernetes controller framework
  159. ### UI & Design System
  160. - **[Spartan](https://github.com/spartan-ng/spartan)** - Collection of UI components for Angular
  161. ## 🤝 How to Contribute to HyprMCP
  162. Your feedback is invaluable to us as we continue to improve HyprMCP and Jetski. If you'd like to contribute, consider trying out the platform, reporting any issues, and sharing your suggestions. See [the contributing guide](CONTRIBUTING.md) for detailed instructions on how you can contribute.
  163. Whether you want to:
  164. - Report bugs or request features
  165. - Contribute code improvements
  166. - Improve documentation
  167. - Share your MCP server use cases
  168. - Help other users in the community
  169. We welcome all contributions!
  170. ## 🤩 Thanks to all our Contributors
  171. Thanks to everyone that is supporting this project. We are thankful for every contribution, no matter its size!
  172. <a href="https://github.com/hyprmcp/jetski/graphs/contributors">
  173. <img src="https://contrib.rocks/image?repo=hyprmcp/jetski" />
  174. </a>
  175. ## 👾 Activity
  176. ![HyprMCP Activity](https://repobeats.axiom.co/api/embed/bb99848dce085afb2ed699790547856069d369cc.svg "HyprMCP activity image")
  177. ## 📘 License
  178. Jetski is licensed under the MIT license. For more information check the [LICENSE](https://github.com/hyprmcp/jetski/blob/main/LICENSE) file for details.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.