NitroStack

What is NitroStack about?

NitroStack offers an opinionated, batteries‑included framework that lets developers create enterprise‑grade MCP servers with minimal boilerplate. It combines decorator‑driven definitions, dependency injection, built‑in authentication, middleware pipelines, and UI widget integration into a single cohesive stack.

How to use NitroStack?

1. Scaffold a project – run npx @nitrostack/cli init my-server.
2. Install dependencies – cd my-server && npm install.
3. Start development – npm run dev. The server starts locally and can be accessed by any MCP‑compatible client.
4. Optional visual debugging – open the folder in NitroStudio (download from https://nitrostack.ai/studio) for real‑time tool testing, widget preview, and AI chat.

Key Features

• Decorator‑driven API – define tools, resources, and prompts with clean TypeScript decorators.
• Dependency Injection – singleton, transient, and scoped lifecycles out of the box.
• Built‑in Auth – JWT, OAuth 2.1, and API‑key strategies ready to use.
• Middleware pipeline – guards, interceptors, pipes, and exception filters.
• UI Widgets – attach React components to tool outputs for rich interactive responses.
• Zod validation – end‑to‑end type safety from schema to runtime.
• NitroStudio – desktop app for debugging, testing, and chatting with the server.
• Modular ecosystem – install only needed packages (@nitrostack/core, @nitrostack/cli, @nitrostack/widgets).

Use Cases

• Building AI‑native backends that expose tool‑based services (search, recommendation, data retrieval).
• Rapid prototyping of agents that require authentication, caching, and UI feedback.
• Enterprise applications needing a structured, type‑safe server layer for Model Context Protocol interactions.
• Developers who want a single framework to manage DI, validation, and UI widgets without stitching together multiple libraries.

FAQ

Q: Do I need to know MCP to use NitroStack? A: No. NitroStack abstracts protocol details; you focus on defining tools and business logic.

Q: Can I use NitroStack with existing Node.js projects? A: Yes. You can add @nitrostack/core to any TypeScript project and register modules manually.

Q: How is deployment handled? A: Use the standard Node.js deployment workflow – Docker, cloud platforms, or serverless – after building the project (npm run build).

Q: What IDE support is available? A: Full TypeScript typings, plus NitroStudio for visual debugging and widget preview.

Q: Where can I get help? A: Join the Discord community, GitHub discussions, or consult the official documentation at https://docs.nitrostack.ai.

Documentation  ·  Quick Start  ·  Blog  ·  NitroStudio  ·  Discord

---

Quick Start

Prerequisites

• Node.js >= 20.18 (download)
• 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

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

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.

Download NitroStudio

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

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

• 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

Community

• Discord — Ask questions, share projects, get help
• GitHub Discussions — Proposals, ideas, and Q&A
• Twitter / X — Announcements and updates
• YouTube — Product demos and walkthroughs
• LinkedIn — Company news and updates
• GitHub — Organization profile and open-source work
• Blog — Tutorials, deep dives, and release notes

Contributing

We welcome contributions of all kinds — bug fixes, features, docs, and ideas. Read the Contributing Guide to get started.

Looking for a place to begin? Check out issues labeled good first issue.

Contributors

License

NitroStack is open-source software licensed under the Apache License 2.0.

---