The full-stack TypeScript framework to build, test, and deploy production-ready MCP servers and AI-native apps.
$ npx -y skills add nitrocloudofficial/nitrostack --agent claude-code
Run the curl in your terminal, the rest in Claude Code.
Repo: nitrocloudofficial/nitrostack
What's inside
Documentation ย ยทย Quick Start ย ยทย Blog ย ยทย NitroStudio ย ยทย Discord
npx @nitrostack/cli init my-server

cd my-server
npm install
npm run dev
Your MCP server is running. Connect it to any MCP-compatible client.
Once your project is scaffolded, open the same folder in NitroStudio for visual testing and debugging.
my-server project folderBuilding 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.
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.
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 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.

| 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 |
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.
NitroStack is open-source software licensed under the Apache License 2.0.
.github/
CODEOWNERS
FUNDING.yml
ISSUE_TEMPLATE/
bug_report.md
feature_request.md
PULL_REQUEST_TEMPLATE.md
.gitignore
assets/
gif/
nitrocli.gif
nitrostudio-chat.gif
nitrostudio-main.gif
nitrostudio-testing.gif
screenshots/
nitrostack-features.png
nitrostack-hero.png
nitrostack-sdk.png
nitrostack-studio.png
CODE_OF_CONDUCT.md
CONTRIBUTING.md
docs/
AI_AGENT_CLI_REFERENCE.md
AI_AGENT_SDK_REFERENCE.md
api-reference/
cli-commands.md
decorators.md
execution-context.md
guards.md
interceptors.md
middleware.md
pipes.md
assets/
nitrostudio.png
cli/
01-introduction.md
02-installation.md
03-init-command.md
04-dev-command.md
05-build-command.md
06-configuration.md
07-install-command.md
08-generate-command.md
09-upgrade-command.md
deployment/
01-checklist.md
02-docker-guide.md
03-cloud-platforms.md
getting-started/
00-introduction.md
01-installation.md
02-quick-start.md
guides/
dual-transport.md
streamable-http-and-legacy-sse.md
verify-transport.md
widget-content-security-policy.md
widget-sdk-migration.md
package-lock.json
README.md
sdk/
typescript/
03-server-concepts.md
04-tools-guide.md
05-resources-guide.md
06-prompts-guide.md
07-middleware-guide.md
08-interceptors-guide.md
09-authentication-overview.md
10-api-key-authentication.md
10-pipes-guide.md
11-oauth-authentication.md
11-validation-guide.md
12-dependency-injection.md
13-error-handling.md
14-testing-guide.md
15-events-guide.md
16-ui-widgets-guide.md
17-best-practices.md
18-widget-sdk-reference.md
19-file-upload-guide.md
20-mcp-tasks-guide.md
api-keys-guide.md
caching-guide.md
oauth-2.1-guide.md
performance.md
rate-limiting-guide.md
STARTER_ISSUES_REVIEW.md
studio/
STUDIO_GUIDE.md
01-overview.md
02-testing-tools.md
03-chat-interface.md
04-standalone-setup.md
templates/
01-starter-template.md
02-oauth-template.md
03-pizzaz-template.md
WIDGET_EXAMPLES_GUIDE.md
WIDGET_MANIFEST.md
LICENSE
logo.png
README.md
sample-apps/
.env
.gitignore
Agent-Nexus/
generate_pitch_pdf.py
mcp.config.json
nitro.config.json
nitro.config.ts
package-lock.json
package.json
README.md
req.txt
run_demo_transcript.ts
src/
app.module.ts
data/
cost_history.csv
dataset_manifest.json
incident_reports.json
inventory_transactions.csv
machines.csv
maintenance_history.csv
production_orders.csv
README.txt
risk_rules.json
spare_parts_master.csv
supplier_database.csv
technician_roster.csv
health/
system.health.ts
index.ts
modules/
calculator/
calculator.module.ts
calculator.prompts.ts
calculator.resources.ts
calculator.tools.ts
decision-twin/
decision-twin.data.ts
decision-twin.module.ts
decision-twin.orchestrator.ts
decision-twin.planner.ts
decision-twin.plant-manager.ts
decision-twin.prompts.ts
decision-twin.resources.ts
decision-twin.state.ts
decision-twin.sub-agents.ts
decision-twin.tools.ts
scenario_simulation_agent.test.ts
scenario_simulation_agent.ts
reflection_memory/
devils_advocate.ts
historical_memory.ts
index.ts
models.ts
negotiation_simulator.ts
reflection_memory.tools.ts
safety_agent.ts
widgets/
app/
calculator-result/
page.tsx
decision-twin-result/
page.tsx
layout.tsx
next-env.d.ts
next.config.js
package-lock.json
package.json
tsconfig.json
widget-manifest.json
test-demo.ts
test-dynamic.ts
test-reconciliation.ts
test-tools.ts
tests/
reflection_memory.test.ts
tsconfig.json
AgentBuilders-Helmsman/
.gitignore
images/
architecture-flow.png
architecture.png
banner.png
dashboard.jpeg
images.md
kind-config.yaml
manifests/
demo.yaml
deployments.yaml
kube-state-metrics.yaml
namespace.yaml
pdbs.yaml
package-lock.json
package.json
README.md
scripts/
demo-chaos.sh
reset-demo.ps1
setup-cluster.ps1
setup.sh
src/
agents/
executor.ts
orchestrator.ts
prompts.ts
tools.ts
app.module.ts
index.ts
modules/
k8s/
audit.ts
client.ts
k8s.module.ts
k8s.prompts.ts
k8s.resources.ts
k8s.tools.ts
policy.data.ts
safety.test.ts
safety.ts
tsconfig.json
AI-Scheduler-NitroStack-Hackathon/
.agents/
skills/
auth-security/
SKILL.md
mcp-app-architecture/
SKILL.md
middleware-pipeline/
SKILL.md
tools-resources-prompts/
SKILL.md
ui-widgets/
SKILL.md
.antigravity/
skills/
auth-security/
SKILL.md
mcp-app-architecture/
SKILL.md
middleware-pipeline/
SKILL.md
tools-resources-prompts/
SKILL.md
ui-widgets/
SKILL.md
.claude/
skills/
auth-security/
SKILL.md
mcp-app-architecture/
SKILL.md
middleware-pipeline/
SKILL.md
tools-resources-prompts/
SKILL.md
ui-widgets/
SKILL.md
.codex/
skills/
auth-security/
SKILL.md
mcp-app-architecture/
SKILL.md
middleware-pipeline/
SKILL.md
tools-resources-prompts/
SKILL.md
ui-widgets/
SKILL.md
.copilot/
skills/
auth-security/
SKILL.md
mcp-app-architecture/
SKILL.md
middleware-pipeline/
SKILL.md
tools-resources-prompts/
SKILL.md
ui-widgets/
SKILL.md
.cursor/
skills/
auth-security/
SKILL.md
mcp-app-architecture/
SKILL.md
middleware-pipeline/
SKILL.md
tools-resources-prompts/
SKILL.md
ui-widgets/
SKILL.md
.gemini/
skills/
auth-security/
SKILL.md
mcp-app-architecture/
SKILL.md
middleware-pipeline/
SKILL.md
tools-resources-prompts/
SKILL.md
ui-widgets/
SKILL.md
.gitignore
.opencode/
skills/
auth-security/
SKILL.md
mcp-app-architecture/
SKILL.md
middleware-pipeline/
SKILL.md
tools-resources-prompts/
SKILL.md
ui-widgets/
SKILL.md
nitro.config.ts
nitro.studio.json
package-lock.json
package.json
README.md
src/
app.module.ts
health/
system.health.ts
index.ts
models/
daily-summary.model.ts
expense.model.ts
habit.model.ts
task.model.ts
user.model.ts
modules/
assistant/
assistant.module.ts
assistant.prompts.ts
assistant.resources.ts
assistant.tools.ts
google-calendar.ts
web/
index.html
server.ts
widgets/
app/
calculator-result/
page.tsx
layout.tsx
next-env.d.ts
next.config.js
package-lock.json
package.json
tsconfig.json
widget-manifest.json
tests/
calendar.integration.test.ts
rescheduling.test.ts
tsconfig.json
Aide/
.agents/
skills/
auth-security/
SKILL.md
mcp-app-architecture/
SKILL.md
middleware-pipeline/
SKILL.md
tools-resources-prompts/
SKILL.md
ui-widgets/
SKILL.md
.antigravity/
skills/
auth-security/
SKILL.md
mcp-app-architecture/
SKILL.md
middleware-pipeline/
SKILL.md
tools-resources-prompts/
SKILL.md
ui-widgets/
SKILL.md
.claude/
skills/
auth-security/
SKILL.md
mcp-app-architecture/
SKILL.md
middleware-pipeline/
SKILL.md
tools-resources-prompts/
SKILL.md
ui-widgets/
SKILL.md
... 1600 moreShowing a partial view of a very large repo.
FAQ
nitrostack is a Claude Code plugin with 199 hand-picked skills for development work, indexed on Flowy. Install it with the command on its page. It includes auth-security, mcp-app-architecture, middleware-pipeline. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.