Руководство по установке macOS

Предпосылки

1.Установить uv (управление пакетами Python):

###Установите MCP-сервер Vast.ai

1. Клон репозитория:

2.Установить зависимости с помощью uv:

3.Установить сервер в качестве инструмента:

Конфигурация

1. ** Получите ключ API Vast.ai** Зарегистрируйтесь на console.vast.ai Перейти в Аккаунт > API Ключи Создайте или скопируйте ключ API

2. ** Настройка MCP-клиента** (для Claude Desktop или других MCP-клиентов):

Обновите конфигурационный файл MCP для Cursor:

###Проверка установки

1.** Проверьте сервер напрямую**:

Настройка ключа SSH (рекомендуется)

Для полной функциональности убедитесь, что у вас установлены SSH-ключи:

1. ** Создайте пару ключей SSH** (если у вас их нет):

2. ** Проверить наличие ключевых файлов**:

Вы должны видеть id_rsa (частные) и id_rsa.pub (публичные) файлы.

###Устранение неполадок

** Разрешение отказано**: Убедитесь, что ваш ключ SSH имеет правильные разрешения:

API ключевые вопросы: Убедитесь, что ключ API правильный и имеет соответствующие разрешения на Vast.ai

Сетевые проблемы: убедитесь, что вы можете связаться с console.vast.ai из вашей сети

Руководство по использованию серверов Vast.ai MCP

В этом документе описывается, как использовать батарею.

Installation

macOS Installation Guide

Prerequisites

1. Install uv (Python package manager):

   brew install uv
   

Install the Vast.ai MCP Server

1. Clone the repository:

   git clone https://github.com/your-repo/vastai-mcp.git
   cd vastai-mcp
   

2. Install dependencies using uv:

   uv sync
   

3. Install the server as a tool:

   uv tool install -e .   # Install from current directory
   

Configuration

1. Get your Vast.ai API key:

   • Log in to console.vast.ai
   • Go to Account > API Keys
   • Create or copy your API key

2. Configure MCP client (for Claude Desktop or other MCP clients):

   Update your MCP configuration file (~/.cursor/mcp.json for Cursor):

   {
     "mcpServers": {
        "vast-ai": {
          "command": "uv",
          "args": [
              "run",
              "vast-mcp-server"
          ],
          "env": {
              "VAST_API_KEY": "your_vast_api_key_here",
              "SSH_KEY_FILE": "~/.ssh/id_rsa",
              "SSH_KEY_PUBLIC_FILE": "~/.ssh/id_rsa.pub"
          }
        }
     }
   }
   

Verify Installation

1. Test the server directly:

   uv tool run vast-mcp-server --help
   

SSH Key Setup (Recommended)

For full functionality, ensure you have SSH keys set up:

1. Generate SSH key pair (if you don’t have one):

   ssh-keygen -t rsa -b 4096 -C "[email protected]"
   

2. Verify key files exist:

   ls -la ~/.ssh/id_rsa*
   

   You should see both id_rsa (private) and id_rsa.pub (public) files.

Troubleshooting

• Permission denied: Make sure your SSH key has correct permissions:

  chmod 600 ~/.ssh/id_rsa
  chmod 644 ~/.ssh/id_rsa.pub
  

• API key issues: Verify your API key is correct and has proper permissions on Vast.ai

• Network issues: Ensure you can reach console.vast.ai from your network

Vast.ai MCP Server Usage Guide

This document describes how to use the Vast.ai MCP (Model Context Protocol) server to interact with the Vast.ai GPU cloud platform.

Available Tools

This server provides 23 tools for managing Vast.ai GPU instances:

1. show_user_info()

Show current user information and account balance.

Returns:

• Username, email, account balance, user ID
• SSH key information (if available)
• Total spent amount

2. show_instances(owner: str = “me”)

Show user’s instances (running, stopped, etc.)

Parameters:

• owner (optional): Owner of instances to show (default: “me”)

Returns:

• List of all instances with their details:
  • Instance ID and status
  • Label and machine ID
  • GPU type and specifications
  • Hourly cost
  • Docker image
  • Public IP address (if available)
  • Creation date

3. search_offers(query: str = “”, limit: int = 20, order: str = “score-”)