Skip to content
Back to search

nitrostack

The full-stack TypeScript framework to build, test, and deploy production-ready MCP servers and AI-native apps.

Safety scan

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

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/nitrocloudofficial/nitrostack with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/nitrocloudofficial/nitrostack'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/nitrocloudofficial--nitrostack/badge.svg)](/listings/nitrocloudofficial--nitrostack)

HTML

<a href="/listings/nitrocloudofficial--nitrostack"><img src="/api/listings/nitrocloudofficial--nitrostack/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.

Prerequisites

- **Node.js** >= 20.18 ([download](https://nodejs.org/)) - **npm** >= 9

1. Scaffold a new project

npx @nitrostack/cli init my-server

2. Start developing

cd my-server
npm install
npm run dev

Your MCP server is running. Connect it to any MCP-compatible client.

3. Open in NitroStudio

Once your project is scaffolded, open the same folder in NitroStudio for visual testing and debugging.

- Download: <https://nitrostack.ai/studio> - Open your `my-server` project folder - Use NitroStudio to test tools, inspect payloads, and chat with your MCP server

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 · 206 lines

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

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <div align="center">
  2. <a href="https://nitrostack.ai">
  3. <img src="logo.png" alt="NitroStack" width="120" />
  4. </a>
  5. <h1>NitroStack</h1>
  6. <p><strong>The enterprise-grade TypeScript framework for building production-ready MCP servers.</strong></p>
  7. <p>Decorators. Dependency Injection. Widgets. One framework to ship AI-native backends.</p>
  8. <br />
  9. <a href="https://www.producthunt.com/products/nitrostack?embed=true&amp;utm_source=badge-top-post-badge&amp;utm_medium=badge&amp;utm_campaign=badge-nitrostack" target="_blank" rel="noopener noreferrer"><img alt="NitroStack - Build, test, and deploy MCP servers in one place | Product Hunt" width="250" height="54" src="https://api.producthunt.com/widgets/embed-image/v1/top-post-badge.svg?post_id=1273961&amp;theme=neutral&amp;period=daily&amp;t=1792301273013"></a>
  10. <br />
  11. <br />
  12. <a href="https://www.npmjs.com/package/@nitrostack/core"><img src="https://img.shields.io/npm/v/@nitrostack/core?style=flat-square&label=%40nitrostack%2Fcore&color=cb0000" alt="npm version" /></a>
  13. <a href="https://www.npmjs.com/package/@nitrostack/core"><img src="https://img.shields.io/npm/dm/@nitrostack/core?style=flat-square&color=cb0000" alt="npm downloads" /></a>
  14. <a href="https://github.com/nitrocloudofficial/nitrostack"><img src="https://img.shields.io/github/stars/nitrocloudofficial/nitrostack?style=flat-square&color=cb0000" alt="GitHub stars" /></a>
  15. <a href="https://opensource.org/licenses/Apache-2.0"><img src="https://img.shields.io/badge/License-Apache%202.0-blue?style=flat-square" alt="License" /></a>
  16. <a href="https://discord.gg/uVWey6UhuD"><img src="https://img.shields.io/badge/Discord-Join%20Community-5865F2?style=flat-square&logo=discord&logoColor=white" alt="Discord" /></a>
  17. <a href="https://x.com/nitrostackai"><img src="https://img.shields.io/badge/Follow-000000?style=flat-square&logo=x&logoColor=white" alt="X" /></a>
  18. <a href="https://www.youtube.com/@nitrostackai"><img src="https://img.shields.io/badge/YouTube-Subscribe-FF0000?style=flat-square&logo=youtube&logoColor=white" alt="YouTube" /></a>
  19. <a href="https://linkedin.com/company/nitrostack-ai/"><img src="https://img.shields.io/badge/LinkedIn-Follow-0A66C2?style=flat-square&logo=linkedin&logoColor=white" alt="LinkedIn" /></a>
  20. <a href="https://github.com/nitrostackai"><img src="https://img.shields.io/badge/GitHub-Organization-181717?style=flat-square&logo=github&logoColor=white" alt="GitHub" /></a>
  21. <br />
  22. <br />
  23. <a href="https://docs.nitrostack.ai"><strong>Documentation</strong></a> &nbsp;&middot;&nbsp;
  24. <a href="https://docs.nitrostack.ai/quick-start"><strong>Quick Start</strong></a> &nbsp;&middot;&nbsp;
  25. <a href="https://blog.nitrostack.ai"><strong>Blog</strong></a> &nbsp;&middot;&nbsp;
  26. <a href="https://nitrostack.ai/studio"><strong>NitroStudio</strong></a> &nbsp;&middot;&nbsp;
  27. <a href="https://discord.gg/uVWey6UhuD"><strong>Discord</strong></a>
  28. <br />
  29. <br />
  30. </div>
  31. ---
  32. ## Quick Start
  33. ### Prerequisites
  34. - **Node.js** >= 20.18 ([download](https://nodejs.org/))
  35. - **npm** >= 9
  36. ### 1. Scaffold a new project
  37. ```bash
  38. npx @nitrostack/cli init my-server
  39. ```
  40. ![NitroStack CLI](assets/gif/nitrocli.gif)
  41. ### 2. Start developing
  42. ```bash
  43. cd my-server
  44. npm install
  45. npm run dev
  46. ```
  47. Your MCP server is running. Connect it to any MCP-compatible client.
  48. ### 3. Open in NitroStudio
  49. Once your project is scaffolded, open the same folder in NitroStudio for visual testing and debugging.
  50. - Download: <https://nitrostack.ai/studio>
  51. - Open your `my-server` project folder
  52. - Use NitroStudio to test tools, inspect payloads, and chat with your MCP server
  53. ## Why NitroStack?
  54. Building MCP servers today means stitching together boilerplate, reinventing authentication, and hoping your tooling scales. NitroStack gives you an opinionated, batteries-included framework so you can focus on what your server actually does.
  55. - **Decorator-driven** — Define tools, resources, and prompts with clean, declarative TypeScript decorators
  56. - **Dependency injection** — First-class DI container with singleton, transient, and scoped lifecycles
  57. - **Auth built in** — JWT, OAuth 2.1, and API key authentication out of the box
  58. - **Middleware pipeline** — Guards, interceptors, pipes, and exception filters just like enterprise backends
  59. - **UI Widgets** — Attach React components to tool outputs for rich, interactive responses
  60. - **Zod validation** — End-to-end type safety from schema to runtime
  61. - **NitroStudio** — A dedicated desktop app for testing, debugging, and chatting with your server
  62. ## See It in Action
  63. ```typescript
  64. import { McpApp, Module, ToolDecorator as Tool, z, ExecutionContext } from '@nitrostack/core';
  65. @McpApp({
  66. module: AppModule,
  67. server: { name: 'my-server', version: '1.0.0' }
  68. })
  69. @Module({ imports: [] })
  70. export class AppModule {}
  71. export class SearchTools {
  72. @Tool({
  73. name: 'search_products',
  74. description: 'Search the product catalog',
  75. inputSchema: z.object({
  76. query: z.string().describe('Search query'),
  77. maxResults: z.number().default(10)
  78. })
  79. })
  80. @UseGuards(ApiKeyGuard)
  81. @Cache({ ttl: 300 })
  82. @Widget('product-grid')
  83. async search(input: { query: string; maxResults: number }, ctx: ExecutionContext) {
  84. ctx.logger.info('Searching products', { query: input.query });
  85. return this.productService.search(input.query, input.maxResults);
  86. }
  87. }
  88. ```
  89. One decorator stack gives you: **API definition + validation + auth + caching + UI** — zero boilerplate.
  90. ## Ecosystem
  91. NitroStack is modular. Install only what you need:
  92. The implementation workspace for NitroStack packages lives in [`typescript/`](./typescript).
  93. | Package | What it does | Install |
  94. |:---|:---|:---|
  95. | [`@nitrostack/core`](./typescript/packages/core) | The framework — decorators, DI, server runtime | `npm i @nitrostack/core` |
  96. | [`@nitrostack/cli`](./typescript/packages/cli) | Scaffolding, dev server, code generators | `npm i -g @nitrostack/cli` |
  97. | [`@nitrostack/widgets`](./typescript/packages/widgets) | React SDK for interactive tool output UIs | `npm i @nitrostack/widgets` |
  98. ## NitroStudio
  99. NitroStudio is a desktop app purpose-built for developing MCP servers. Open your project folder — it handles the dev server for you.
  100. ![NitroStudio](assets/gif/nitrostudio-main.gif)
  101. **[Download NitroStudio](https://nitrostack.ai/studio)**
  102. <table>
  103. <tr>
  104. <td width="50%">
  105. **Real-time tool testing**
  106. Execute tools, inspect payloads, and debug request/response cycles.
  107. ![Testing](assets/gif/nitrostudio-testing.gif)
  108. </td>
  109. <td width="50%">
  110. **Built-in AI chat**
  111. Talk to your MCP server through an integrated AI assistant.
  112. ![AI Chat](assets/gif/nitrostudio-chat.gif)
  113. </td>
  114. </tr>
  115. </table>
  116. - **Widget preview** — Instantly visualize your interactive UI components
  117. - **Hot reload** — Changes reflect in real time as you develop
  118. ## Documentation
  119. | Resource | Description |
  120. |:---|:---|
  121. | [Getting Started](https://docs.nitrostack.ai/getting-started) | Installation, quick start, and first project |
  122. | [Server Concepts](https://docs.nitrostack.ai/sdk/typescript/server-concepts) | Modules, DI, and architecture deep dive |
  123. | [Tools Guide](https://docs.nitrostack.ai/sdk/typescript/tools-guide) | Defining tools, validation, annotations |
  124. | [Widgets Guide](https://docs.nitrostack.ai/sdk/typescript/ui-widgets-guide) | Building interactive UI components |
  125. | [Authentication](https://docs.nitrostack.ai/sdk/typescript/authentication-overview) | JWT, OAuth 2.1, API key setup |
  126. | [CLI Reference](https://docs.nitrostack.ai/cli/introduction) | All CLI commands and options |
  127. | [Deployment](https://docs.nitrostack.ai/deployment/checklist) | Production checklist, Docker, cloud platforms |
  128. ## Community
  129. - [Discord](https://discord.gg/uVWey6UhuD) — Ask questions, share projects, get help
  130. - [GitHub Discussions](https://github.com/nitrocloudofficial/nitrostack/discussions) — Proposals, ideas, and Q&A
  131. - [Twitter / X](https://x.com/nitrostackai) — Announcements and updates
  132. - [YouTube](https://www.youtube.com/@nitrostackai) — Product demos and walkthroughs
  133. - [LinkedIn](https://linkedin.com/company/nitrostack-ai/) — Company news and updates
  134. - [GitHub](https://github.com/nitrostackai) — Organization profile and open-source work
  135. - [Blog](https://blog.nitrostack.ai) — Tutorials, deep dives, and release notes
  136. ## Contributing
  137. We welcome contributions of all kinds — bug fixes, features, docs, and ideas. Read the **[Contributing Guide](./CONTRIBUTING.md)** to get started.
  138. Looking for a place to begin? Check out issues labeled [**good first issue**](https://github.com/nitrocloudofficial/nitrostack/labels/good%20first%20issue).
  139. ## Contributors
  140. <a href="https://github.com/nitrocloudofficial/nitrostack/graphs/contributors">
  141. <img src="https://contrib.rocks/image?repo=nitrocloudofficial/nitrostack" alt="Contributors" />
  142. </a>
  143. ## License
  144. NitroStack is open-source software licensed under the [Apache License 2.0](./LICENSE).
  145. ---
  146. <div align="center">
  147. <sub>Built by the <a href="https://nitrostack.ai">NitroStack</a> team and contributors.</sub>
  148. </div>

Ratings and comments

Sign in to rate this skill.

Sign in

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