https://github.com/nitrocloudofficial/nitrostack
The full-stack TypeScript framework to build, test, and deploy production-ready MCP servers and AI-native apps.
https://github.com/nitrocloudofficial/nitrostack
agentic-ai ai chatgpt chatgpt-apps claude claude-apps mcp mcp-client mcp-server mcp-servers mcp-tools mcpagents mcpapps model-context-protocol modelcontextprotocol
Last synced: 1 day ago
JSON representation
The full-stack TypeScript framework to build, test, and deploy production-ready MCP servers and AI-native apps.
- Host: GitHub
- URL: https://github.com/nitrocloudofficial/nitrostack
- Owner: nitrocloudofficial
- License: apache-2.0
- Created: 2026-03-03T06:51:16.000Z (7 days ago)
- Default Branch: main
- Last Pushed: 2026-03-03T14:02:26.000Z (7 days ago)
- Last Synced: 2026-03-07T17:22:36.654Z (3 days ago)
- Topics: agentic-ai, ai, chatgpt, chatgpt-apps, claude, claude-apps, mcp, mcp-client, mcp-server, mcp-servers, mcp-tools, mcpagents, mcpapps, model-context-protocol, modelcontextprotocol
- Language: TypeScript
- Homepage: https://nitrostack.ai
- Size: 13.9 MB
- Stars: 17
- Watchers: 1
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
- Security: SECURITY.md
Awesome Lists containing this project
README
NitroStack
The enterprise-grade TypeScript framework for building production-ready MCP servers.
Decorators. Dependency Injection. Widgets. One framework to ship AI-native backends.
Documentation ·
Quick Start ·
Blog ·
NitroStudio ·
Discord
---
## Quick Start
### Prerequisites
- **Node.js** >= 20.18 ([download](https://nodejs.org/))
- **npm** >= 9
### 1. Scaffold a new project
```bash
npx @nitrostack/cli init my-server
```
### 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:
- 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/`](./typescript).
| Package | What it does | Install |
|:---|:---|:---|
| [`@nitrostack/core`](./typescript/packages/core) | The framework — decorators, DI, server runtime | `npm i @nitrostack/core` |
| [`@nitrostack/cli`](./typescript/packages/cli) | Scaffolding, dev server, code generators | `npm i -g @nitrostack/cli` |
| [`@nitrostack/widgets`](./typescript/packages/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](https://nitrostack.ai/studio)**
**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](https://docs.nitrostack.ai/getting-started) | Installation, quick start, and first project |
| [Server Concepts](https://docs.nitrostack.ai/sdk/typescript/server-concepts) | Modules, DI, and architecture deep dive |
| [Tools Guide](https://docs.nitrostack.ai/sdk/typescript/tools-guide) | Defining tools, validation, annotations |
| [Widgets Guide](https://docs.nitrostack.ai/sdk/typescript/ui-widgets-guide) | Building interactive UI components |
| [Authentication](https://docs.nitrostack.ai/sdk/typescript/authentication-overview) | JWT, OAuth 2.1, API key setup |
| [CLI Reference](https://docs.nitrostack.ai/cli/introduction) | All CLI commands and options |
| [Deployment](https://docs.nitrostack.ai/deployment/checklist) | Production checklist, Docker, cloud platforms |
## Community
- [Discord](https://discord.gg/5fMj9FUA) — Ask questions, share projects, get help
- [GitHub Discussions](https://github.com/nitrocloudofficial/nitrostack/discussions) — Proposals, ideas, and Q&A
- [Twitter / X](https://x.com/nitrostackai) — Announcements and updates
- [YouTube](https://www.youtube.com/@nitrostackai) — Product demos and walkthroughs
- [LinkedIn](https://linkedin.com/company/nitrostack-ai/) — Company news and updates
- [GitHub](https://github.com/nitrostackai) — Organization profile and open-source work
- [Blog](https://blog.nitrostack.ai) — Tutorials, deep dives, and release notes
## Contributing
We welcome contributions of all kinds — bug fixes, features, docs, and ideas. Read the **[Contributing Guide](./CONTRIBUTING.md)** to get started.
Looking for a place to begin? Check out issues labeled [**good first issue**](https://github.com/nitrocloudofficial/nitrostack/labels/good%20first%20issue).
## Contributors
## License
NitroStack is open-source software licensed under the [Apache License 2.0](./LICENSE).
---