nitrocloudofficial/nitrostack — Gitpedia

<div align="center"> <a href="https://nitrostack.ai"> <img src="logo.png" alt="NitroStack" width="120" /> </a> <h1>NitroStack</h1> <p><strong>The enterprise-grade TypeScript framework for building production-ready MCP servers.</strong></p> <p>Decorators. Dependency Injection. Widgets. One framework to ship AI-native backends.</p> <br />

<a href="https://docs.nitrostack.ai"><strong>Documentation</strong></a> ·
<a href="https://docs.nitrostack.ai/quick-start"><strong>Quick Start</strong></a> ·
<a href="https://blog.nitrostack.ai"><strong>Blog</strong></a> ·
<a href="https://nitrostack.ai/studio"><strong>NitroStudio</strong></a> ·
<a href="https://discord.gg/uVWey6UhuD"><strong>Discord</strong></a>

Quick Start

Prerequisites

Node.js >= 20.18 (download)
npm >= 9

1. Scaffold a new project

bash
npx @nitrostack/cli init my-server

NitroStack CLI

2. Start developing

bash
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

Why NitroStack?

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.

Decorator-driven — Define tools, resources, and prompts with clean, declarative TypeScript decorators
Dependency injection — First-class DI container with singleton, transient, and scoped lifecycles
Auth built in — JWT, OAuth 2.1, and API key authentication out of the box
Middleware pipeline — Guards, interceptors, pipes, and exception filters just like enterprise backends
UI Widgets — Attach React components to tool outputs for rich, interactive responses
Zod validation — End-to-end type safety from schema to runtime
NitroStudio — A dedicated desktop app for testing, debugging, and chatting with your server

See It in Action

typescript
import { McpApp, Module, ToolDecorator as Tool, z, ExecutionContext } from '@nitrostack/core';

@McpApp({
  module: AppModule,
  server: { name: 'my-server', version: '1.0.0' }
})
@Module({ imports: [] })
export class AppModule {}

export class SearchTools {
  @Tool({
    name: 'search_products',
    description: 'Search the product catalog',
    inputSchema: z.object({
      query: z.string().describe('Search query'),
      maxResults: z.number().default(10)
    })
  })
  @UseGuards(ApiKeyGuard)
  @Cache({ ttl: 300 })
  @Widget('product-grid')
  async search(input: { query: string; maxResults: number }, ctx: ExecutionContext) {
    ctx.logger.info('Searching products', { query: input.query });
    return this.productService.search(input.query, input.maxResults);
  }
}

One decorator stack gives you: API definition + validation + auth + caching + UI — zero boilerplate.

Ecosystem

NitroStack is modular. Install only what you need:
The implementation workspace for NitroStack packages lives in typescript/.

Package	What it does	Install
`@nitrostack/core`	The framework — decorators, DI, server runtime	`npm i @nitrostack/core`
`@nitrostack/cli`	Scaffolding, dev server, code generators	`npm i -g @nitrostack/cli`
`@nitrostack/widgets`	React SDK for interactive tool output UIs	`npm i @nitrostack/widgets`

NitroStudio

NitroStudio is a desktop app purpose-built for developing MCP servers. Open your project folder — it handles the dev server for you.

NitroStudio

Download NitroStudio

Real-time tool testing
Execute tools, inspect payloads, and debug request/response cycles.

Testing

</td> <td width="50%">

Built-in AI chat
Talk to your MCP server through an integrated AI assistant.

AI Chat

</td> </tr> </table>

Widget preview — Instantly visualize your interactive UI components
Hot reload — Changes reflect in real time as you develop

Documentation

Resource	Description
Getting Started	Installation, quick start, and first project
Server Concepts	Modules, DI, and architecture deep dive
Tools Guide	Defining tools, validation, annotations
Widgets Guide	Building interactive UI components
Authentication	JWT, OAuth 2.1, API key setup
CLI Reference	All CLI commands and options
Deployment	Production checklist, Docker, cloud platforms