# NitroStack MCP server

> Lets developers build, test, and deploy TypeScript MCP servers with decorators, dependency injection, auth, and UI widgets.

- Repository: https://github.com/nitrocloudofficial/nitrostack
- Page: https://hostedmcp.org/servers/nitrocloudofficial/nitrostack
- Transport: stdio
- Stars: 2565
- License: Apache-2.0

## Install

### Claude Code

```sh
claude mcp add nitrostack -- npx -y @nitrostack/cli
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "nitrostack": {
      "command": "npx",
      "args": [
        "-y",
        "@nitrostack/cli"
      ]
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "nitrostack": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@nitrostack/cli"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"nitrostack","type":"stdio","command":"npx","args":["-y","@nitrostack/cli"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "nitrostack": {
      "command": "npx",
      "args": [
        "-y",
        "@nitrostack/cli"
      ]
    }
  }
}
```

### Codex

```sh
codex mcp add nitrostack -- npx -y @nitrostack/cli
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.nitrostack]
command = "npx"
args = ["-y", "@nitrostack/cli"]
```

### Gemini CLI

```sh
gemini mcp add -s user nitrostack npx -- -y @nitrostack/cli
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "nitrostack": {
      "command": "npx",
      "args": [
        "-y",
        "@nitrostack/cli"
      ]
    }
  }
}
```

## FAQ

### 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.
