# Novita MCP Server
[![smithery badge](https://smithery.ai/badge/@novitalabs/novita-mcp-server)](https://smithery.ai/server/@novitalabs/novita-mcp-server)

`novita-mcp-server` is a Model Context Protocol (MCP) server that provides seamless interaction with Novita AI platform resources. We recommend accessing this server through [Claude Desktop](https://claude.ai/download), [Cursor](https://www.cursor.com/), or any other compatible MCP client.

<a href="https://glama.ai/mcp/servers/@novitalabs/novita-mcp-server">
  <img width="380" height="200" src="https://glama.ai/mcp/servers/@novitalabs/novita-mcp-server/badge" alt="Novita Server MCP server" />
</a>

## Features

> ⚠️ **Beta Notice**: `novita-mcp-server` is currently in beta and only supports GPU instance management. Additional resource types will be supported in future releases.

Currently, `novita-mcp-server` enables management the resources of [GPU instances product](https://novita.ai/gpus-console). 

Supported operations are as follows:
- Cluster(/Region): List;
- Product: List;
- GPU Instance: List, Get, Create, Start, Stop, Delete, Restart;
- Template: List, Get, Create, Delete;
- Container Registry Auth: List, Create, Delete;
- Network Storage: List, Create, Update, Delete;

## Installation

You can install the package using npm, or Smithery:

**Using npm**

```bash
npm install -g @novitalabs/novita-mcp-server
```

**Using Smithery**

Visit the [https://smithery.ai/server/@novitalabs/novita-mcp-server](https://smithery.ai/server/@novitalabs/novita-mcp-server) and follow the "Install" instructions to install the server.

## Configuration to use novita-mcp-server

First, you need to get your Novita API key from the [Novita AI Key Management](https://novita.ai/settings/key-management).

And next, you can use the following configuration for both Claude Desktop and Cursor:

> 📌 **Tips**
> 
> For Claude Desktop, you can refer to the [Claude Desktop MCP Quickstart](https://modelcontextprotocol.io/quickstart/user) guide to learn how to configure the MCP server.
> 
> For Cursor, you can refer to the [Cursor MCP Quickstart](https://docs.cursor.com/context/model-context-protocol) guide to learn how to configure the MCP server.

```json
{
  "mcpServers": {
    "@novitalabs/novita-mcp-server": {
      "command": "npx",
      "args": ["-y", "@novitalabs/novita-mcp-server"],
      "env": {
        "NOVITA_API_KEY": "your_api_key_here"
      }
    }
  }
}
```

## Examples

Here are some examples of how to use the `novita-mcp-server` to manage your resources with Claude Desktop or Cursor:

### List clusters

```txt
List all the Novita clusters
```

### List products

```txt
List all available Novita GPU instance products
```

### List GPU instances

```txt
List all my running Novita GPU instances
```

### Create a new GPU instance

```txt
Create a new Novita GPU instance:

Name: test-novita-mcp-server-01
Product: any available product
GPU Number: 1
Image: A standard public PyTorch/CUDA image
Container Disk: 60GB
```

## Testing

This project uses Jest for testing. The tests are located in the src/__tests__ directory.

You can run the tests using one of the following commands:

```bash
npm test
```