{"id":32032640,"url":"https://github.com/hyprmcp/jetski","last_synced_at":"2025-10-24T16:58:20.376Z","repository":{"id":318685621,"uuid":"1013141089","full_name":"hyprmcp/jetski","owner":"hyprmcp","description":"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","archived":false,"fork":false,"pushed_at":"2025-10-24T03:09:39.000Z","size":5806,"stargazers_count":173,"open_issues_count":8,"forks_count":7,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-24T05:25:35.184Z","etag":null,"topics":["ai","angular","authentication","dynamic-client-registration","go","golang","kubernetes","mcp","mcp-analytics","mcp-gateway","mcp-proxy","mcp-security","metacontroller","model-context-protocol","oauth2","oauth2-proxy","typescript"],"latest_commit_sha":null,"homepage":"https://hyprmcp.com/docs/getting-started/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hyprmcp.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-07-03T12:24:30.000Z","updated_at":"2025-10-23T16:51:30.000Z","dependencies_parsed_at":"2025-10-08T17:45:08.905Z","dependency_job_id":"99dbbba5-9d78-49b1-96b1-191aac188279","html_url":"https://github.com/hyprmcp/jetski","commit_stats":null,"previous_names":["hyprmcp/jetski"],"tags_count":31,"template":false,"template_full_name":null,"purl":"pkg:github/hyprmcp/jetski","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hyprmcp%2Fjetski","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hyprmcp%2Fjetski/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hyprmcp%2Fjetski/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hyprmcp%2Fjetski/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hyprmcp","download_url":"https://codeload.github.com/hyprmcp/jetski/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hyprmcp%2Fjetski/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":280833013,"owners_count":26398971,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-24T02:00:06.418Z","response_time":73,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","angular","authentication","dynamic-client-registration","go","golang","kubernetes","mcp","mcp-analytics","mcp-gateway","mcp-proxy","mcp-security","metacontroller","model-context-protocol","oauth2","oauth2-proxy","typescript"],"created_at":"2025-10-17T02:00:34.373Z","updated_at":"2025-10-24T16:58:20.347Z","avatar_url":"https://github.com/hyprmcp.png","language":"TypeScript","funding_links":[],"categories":["Open-source MCP Gateways","📚 Projects (1974 total)","TypeScript"],"sub_categories":["MCP Servers"],"readme":"[![GitHub Repo stars](https://img.shields.io/github/stars/hyprmcp/jetski?style=flat)](https://github.com/hyprmcp/jetski)\n[![License](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)\n[![Docs](https://img.shields.io/badge/docs-hyprmcp.com%2Fdocs-blue)](https://hyprmcp.com/docs/getting-started/?utm_source=github)\n[![PRs](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)\n[![Discord](https://img.shields.io/badge/HyprMCP-Discord-%235865F2.svg)](https://discord.gg/CgZ775fcsy)\n[![Downloads](https://img.shields.io/github/downloads/hyprmcp/jetski/total)](https://github.com/hyprmcp/jetski/releases)\n[![Go Reference](https://pkg.go.dev/badge/github.com/hyprmcp/jetski)](https://pkg.go.dev/github.com/hyprmcp/jetski)\n[![Go Report Card](https://goreportcard.com/badge/github.com/hyprmcp/jetski)](https://goreportcard.com/report/github.com/hyprmcp/jetski)\n\n\u003cbr\u003e\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://hyprmcp.com?utm_source=github\"\u003e\n    \u003cimg src=\"./.readme/hyprmcp.webp\" alt=\"HyprMCP Logo\" height=\"160\"\u003e\n  \u003c/a\u003e\n\n\u003ch3 align=\"center\"\u003e🚤 MCP Analytics and Authentication Platform 🔐\u003c/h3\u003e\n\n  \u003cp align=\"center\"\u003e\n    \u003ca href=\"https://app.hyprmcp.com/?utm_source=github\"\u003e\u003cstrong\u003eGet started with HyprMCP Cloud »\u003c/strong\u003e\u003c/a\u003e\n    \u003cbr\u003e \u003cbr\u003e\n    \u003ca href=\"https://hyprmcp.com/?utm_source=github\"\u003e\u003cstrong\u003eExplore our website »\u003c/strong\u003e\u003c/a\u003e\n    \u003cbr\u003e \u003cbr\u003e\n    \u003ca href=\"https://hyprmcp.com/docs/\"\u003e\u003cstrong\u003eRead the docs »\u003c/strong\u003e\u003c/a\u003e\n    \u003cbr\u003e \u003cbr\u003e\n    \u003ca href=\"https://github.com/hyprmcp\" target=\"_blank\"\u003eGitHub\u003c/a\u003e\n    .\n    \u003ca href=\"https://www.linkedin.com/company/glasskube/\" target=\"_blank\"\u003eLinkedIn\u003c/a\u003e\n    .\n     \u003ca href=\"https://x.com/intent/follow?screen_name=glasskube\" target=\"_blank\"\u003eTwitter / X\u003c/a\u003e\n  \u003c/p\u003e\n\u003c/div\u003e\n\n\u003chr\u003e\n\n## 🚤 What is Jetski?\n\nJetski is an **Open Source MCP Analytics and Authentication Platform** - part of HyprMCP.\nIt solves the three biggest problems teams face when developing MCP servers with **zero code changes**:\n\n1. **Installation \u0026 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.\n2. **Authentication**: Identifying users and giving them the right tools and responses is still painful to implement.\n3. **Logs, Analytics \u0026 Visibility**: No insight into how your MCP is used, which prompts trigger which tools, or why errors happen.\n\nOur 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.\nIt also collects and aggregates all analytics and metrics data captured by the gateway.\n\n\u003e [!IMPORTANT]\n\u003e Note that Jetski in under active development and is still in its infancy.\n\u003e The APIs and command-line interface may change in a backwards incompatible manner.\n\n\n## 🗄️ Table Of Contents\n\n- [What is Jetski?](https://github.com/hyprmcp/jetski#-what-is-jetski)\n- [Features](https://github.com/hyprmcp/jetski#-features)\n- [Quick Start](https://github.com/hyprmcp/jetski#-quick-start---get-started-in-minutes)\n- [Demo Video](https://github.com/hyprmcp/jetski#-hyprmcp-demo-video)\n- [HyprMCP Components](https://github.com/hyprmcp/jetski#-hyprmcp-components)\n- [Architecture Diagram](https://github.com/hyprmcp/jetski#architecture-diagram)\n- [Need Help?](https://github.com/hyprmcp/jetski#-need-help-or-want-to-provide-feedback)\n- [Used Projects](https://github.com/hyprmcp/jetski#-used-projects)\n- [How to Contribute](https://github.com/hyprmcp/jetski#-how-to-contribute-to-hyprmcp)\n- [Contributors](https://github.com/hyprmcp/jetski#-thanks-to-all-our-contributors)\n- [Activity](https://github.com/hyprmcp/jetski#-activity)\n- [License](https://github.com/hyprmcp/jetski#-license)\n\n## ✨ Features\n|                                                                                                                                                                                                                                                         |                                                                                            |\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------|\n| **Comprehensive Prompt Analytics** \u003cbr\u003e See which prompts triggered which tools, from which clients, and what happened.\u003cbr\u003eGain complete visibility into your MCP server usage patterns and understand how users interact with your tools in real-time. | \u003cimg src=\".readme/mcp-prompt-analytics.webp\" alt=\"Prompt Analytics\" style=\"width: 1000px\"\u003e |\n| **Auto-Generated Setup Instructions** \u003cbr\u003e Help users connect to the client effortlessly.\u003cbr\u003eWe automatically generate clear, step-by-step instructions for every supported MCP client, eliminating the #1 reason users churn during onboarding.        | \u003cimg src=\".readme/mcp-instructions.webp\" alt=\"Setup Instructions\" style=\"width: 1000px\"\u003e   |\n| **Zero-Code Authentication** \u003cbr\u003e Identify and manage users securely without writing a single line of code.\u003cbr\u003eOur proxy handles all authentication logic, allowing you to provide personalized tools and responses based on user identity.             | \u003cimg src=\".readme/mcp-authentication.webp\" alt=\"Authentication\" style=\"width: 1000px\"\u003e     |\n| **Real-Time Debug Logs** \u003cbr\u003e Instantly debug issues and understand server behavior in real-time.\u003cbr\u003eSee detailed logs of every request, response, and error, making it easy to identify and fix problems quickly.                                      | \u003cimg src=\".readme/mcp-logs.webp\" alt=\"Debug Logs\" style=\"width: 1000px\"\u003e                   |\n\n\n## 🚀 Quick Start - Get Started in Minutes\n\n\u003e [!TIP]\n\u003e Get started with our fully managed HyprMCP Cloud at [https://app.hyprmcp.com](https://app.hyprmcp.com/).\n\nHyprMCP uses [mise](https://mise.jdx.dev/) to configure your development environment and execute development tasks.\n\n### 1. Jetski Analytics Platform\n\n**Clone the repository:**\n  ```bash\n  git clone https://github.com/hyprmcp/jetski.git\n  cd jetski\n  ```\n\n**Install dependencies:**\n  ```bash\n  mise trust\n  mise install\n  pnpm i\n  cp .dex.secret.env.example .dex.secret.env\n  docker compose up -d\n  ```\n\n**Set host file entry:**\n  ```bash\n  echo -e \"\\n127.0.0.1    host.minikube.internal\\n\" | sudo tee -a /etc/hosts\n  ```\n\n**Start the platform:**\n\nIn Terminal 1, start the backend:\n  ```bash\n  mise run serve\n  ```\n\nIn Terminal 2, start the frontend:\n  ```bash\n  pnpm run start\n  ```\n\nGenerate demo data:\n  ```bash\n  mise run generate\n  ```\n\nAccess the frontend at `http://localhost:4200` and log in with: `admin@example.com` / `password`\n\n### 2. Jetski MCP Gateway Orchestration (Optional)\n\nFor Kubernetes orchestration, we recommend [Minikube](https://minikube.sigs.k8s.io/docs/) for local testing.\n\n**Setup Kubernetes:**\n  ```bash\n  # Start Minikube\n  mise run minikube-start\n\n  # Deploy metacontroller (⚠️ operates against current kubectl context)\n  mise run serve -- --install-controller\n  ```\n\n## 🎬 HyprMCP Demo Video\n\n[![HyprMCP Demo Video](https://i.ytimg.com/vi/m2-YyfjXap4/hq720.jpg)](https://www.youtube.com/watch?v=m2-YyfjXap4)\n\n## 🎯 HyprMCP Components\n\nThe HyprMCP platform is built on several open-source components that work together to provide a comprehensive MCP management solution:\n\n### Core Components\n\n- **[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.\n\n- **[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.\n\nYou can find all our components and contribute to them on [github.com/hyprmcp](https://github.com/hyprmcp).\n\n## Architecture Diagram\n\n```mermaid\ngraph LR\n  Client([🤖 \u003cb\u003eMCP Client\u003c/b\u003e\u003cbr/\u003eClaude, ChatGPT...\u003cbr/\u003e.\u003cbr/\u003e])\n\n  subgraph K8s[\"☸️ HyprMCP\"]\n    direction TB\n    Platform[🚤 \u003cb\u003eJetski Platform\u003c/b\u003e\u003cbr/\u003eKubernetes Client, Dashboards, etc.\u003cbr/\u003e.\u003cbr/\u003e]\n    Gateway[🔄 \u003cb\u003eMCP Gateway\u003c/b\u003e\u003cbr/\u003eAuth, proxy, analytics \u0026 logging\u003cbr/\u003e.\u003cbr/\u003e]\n    Platform-.deploys \u0026 manages.-\u003eGateway\n    Gateway-.sends metrics \u0026 logs.-\u003ePlatform\n  end\n\n  MCP[🚀 \u003cb\u003eYour MCP Server\u003c/b\u003e\u003cbr/\u003eRuns unchanged, anywhere]\n\n  Client \u003c--\u003e K8s\n  K8s \u003c--\u003e MCP\n\n  classDef client fill:#fff9c4,stroke:#f57f17,stroke-width:2px\n  classDef cluster fill:#e3f2fd,stroke:#1565c0,stroke-width:2px\n  classDef platform fill:#f3e5f5,stroke:#4a148c,stroke-width:2px\n  classDef server fill:#e8f5e8,stroke:#2e7d32,stroke-width:2px\n\n  class Client client\n  class K8s cluster\n  class Platform,Gateway platform\n  class MCP server\n```\n\n**How it works:**\n1. **MCP Client** (Claude Desktop, Cline, etc.) sends requests to HyprMCP instead of directly to your server\n2. **HyprMCP Proxy** authenticates the user and validates permissions\n3. **Request forwarding** to your unchanged MCP server\n4. **Response handling** with automatic logging, analytics capture, and monitoring\n5. **Real-time dashboard** provides visibility into all operations\n\n## ☝️ Need Help or Want to Provide Feedback?\n\nIf you encounter any problems, we will be happy to support you wherever we can on our [Discord](https://discord.gg/CgZ775fcsy).\nFor bugs, issues or feature requests feel free to [open an issue](https://github.com/hyprmcp/jetski/issues/new/choose).\nWe are happy to assist you with anything related to the project.\n\n## 📎 Used Projects\n\nHyprMCP is built on top of many amazing open-source projects:\n\n### Core Technologies\n- **[Go](https://github.com/golang/go)** - Primary backend language for the platform\n- **[Angular](https://github.com/angular/angular)** - Frontend framework for the dashboard UI\n- **[Kubernetes](https://github.com/kubernetes/kubernetes)** - Container orchestration platform\n- **[PostgreSQL](https://github.com/postgres/postgres)** - Primary database for storing analytics and metadata\n\n### MCP \u0026 Authentication\n- **[MCP Go SDK](https://github.com/modelcontextprotocol/go-sdk)** - Official Go SDK for Model Context Protocol\n- **[Dex](https://github.com/dexidp/dex)** - OpenID Connect (OIDC) identity provider for authentication\n\n### Kubernetes \u0026 Infrastructure\n- **[Metacontroller](https://github.com/metacontroller/metacontroller)** - Lightweight Kubernetes controller framework\n\n### UI \u0026 Design System\n- **[Spartan](https://github.com/spartan-ng/spartan)** - Collection of UI components for Angular\n\n## 🤝 How to Contribute to HyprMCP\n\nYour 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.\n\nWhether you want to:\n- Report bugs or request features\n- Contribute code improvements\n- Improve documentation\n- Share your MCP server use cases\n- Help other users in the community\n\nWe welcome all contributions!\n\n## 🤩 Thanks to all our Contributors\n\nThanks to everyone that is supporting this project. We are thankful for every contribution, no matter its size!\n\n\u003ca href=\"https://github.com/hyprmcp/jetski/graphs/contributors\"\u003e\n  \u003cimg src=\"https://contrib.rocks/image?repo=hyprmcp/jetski\" /\u003e\n\u003c/a\u003e\n\n## 👾 Activity\n\n![HyprMCP Activity](https://repobeats.axiom.co/api/embed/bb99848dce085afb2ed699790547856069d369cc.svg \"HyprMCP activity image\")\n\n## 📘 License\n\nJetski is licensed under the MIT license. For more information check the [LICENSE](https://github.com/hyprmcp/jetski/blob/main/LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhyprmcp%2Fjetski","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhyprmcp%2Fjetski","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhyprmcp%2Fjetski/lists"}