Lets developers build, test, and deploy TypeScript MCP servers with decorators, dependency injection, auth, and UI widgets.
Also known as nitrocloudofficial/nitrostack, @nitrostack/cli, @nitrostack/core, @nitrostack/widgets
- Stars
- 2,565
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Nov 11, 2026
- License
- Apache-2.0
What is NitroStack MCP?
NitroStack lets developers build, test, and deploy TypeScript MCP servers with decorators, dependency injection, auth, and UI widgets.
Summary generated from the project's README
About NitroStack MCP server
Building production-ready TypeScript MCP servers is the primary focus for developers using this framework. It provides an opinionated environment that handles common backend requirements like authentication, dependency injection, and schema validation through a decorator-driven approach. Developers can use the @nitrostack/cli to scaffold new projects and manage the development lifecycle.
Users can integrate various security protocols including JWT, OAuth 2.1, and API keys directly into their server logic. The framework also supports attaching React components to tool outputs via UI widgets, allowing for interactive responses within an AI client. For testing and debugging, the NitroStudio desktop application provides a visual interface to execute tools, inspect payloads, and chat with the server in real time.
This setup requires Node.js version 20.18 or higher and npm version 9 or higher. The ecosystem is modular, allowing developers to install specific packages like @nitrostack/core for the runtime or @nitrostack/widgets for building interactive user interfaces.
What you can do with it
- 1Scaffold a new projectA developer can quickly initialize a new MCP server directory using the command line interface.
- 2Creating interactive tool outputsYou can attach React components to tool outputs to provide rich, interactive responses to users.
- 3Implementing secure tool accessDevelopers can protect specific tools using built-in authentication guards like API keys.
Written from the project's README. Every use case is checked against a quote from it.
How to install NitroStack MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall NitroStack MCP in Claude Code
$ claude mcp add nitrostack -- npx -y @nitrostack/cliInstall NitroStack MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"nitrostack": {
"command": "npx",
"args": [
"-y",
"@nitrostack/cli"
]
}
}
}Install NitroStack MCP in VS Code
.vscode/mcp.json
{
"servers": {
"nitrostack": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@nitrostack/cli"
]
}
}
}Install NitroStack MCP in VS Code CLI
$ code --add-mcp '{"name":"nitrostack","type":"stdio","command":"npx","args":["-y","@nitrostack/cli"]}'Install NitroStack MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"nitrostack": {
"command": "npx",
"args": [
"-y",
"@nitrostack/cli"
]
}
}
}Install NitroStack MCP in Codex
$ codex mcp add nitrostack -- npx -y @nitrostack/cliInstall NitroStack MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.nitrostack] command = "npx" args = ["-y", "@nitrostack/cli"]
Install NitroStack MCP in Gemini CLI
$ gemini mcp add -s user nitrostack npx -- -y @nitrostack/cliInstall NitroStack MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"nitrostack": {
"command": "npx",
"args": [
"-y",
"@nitrostack/cli"
]
}
}
}Automated checks
Ran Nov 12, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablePass
- Open source license (OSI)Pass
- Commit or release in the last yearPass
- Package name not close to a popular packagePass
- Remote endpoint uses HTTPSNot checked
- Destructive tools are labelledNot checked
- No hidden instructions to the modelPass
- No critical advisory in the package or its dependenciesNot checked
README
View on GitHub
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-serverproject 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.

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.
NitroStack MCP questions
How do I add NitroStack MCP to Claude Code?
Run claude mcp add nitrostack -- npx -y @nitrostack/cli in your terminal. Add --scope user to make it available in every project.
How do I add NitroStack MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What is NitroStack?
NitroStack is an enterprise-grade TypeScript framework for building production-ready MCP servers and AI-native backends. It includes decorators, dependency injection, widgets, and built-in auth.
How do I scaffold a new NitroStack MCP server project?
Run npx @nitrostack/cli init my-server, then cd into the folder, install dependencies, and run npm run dev. Requires Node.js >= 20.18 and npm >= 9.
Does NitroStack support authentication?
Yes, it provides JWT, OAuth 2.1, and API key authentication out of the box. Guards like ApiKeyGuard can be applied with decorators.
What is NitroStudio?
NitroStudio is a desktop app for testing, debugging, and chatting with your MCP server. You open your project folder and it handles the dev server for you.
Can I attach UI components to MCP tool outputs?
Yes, the @nitrostack/widgets package is a React SDK that lets you attach interactive UI components to tool outputs via the @Widget decorator.