prime-intellect-mcp

Позвольте Claude Code самостоятельно арендовать, запускать и завершать работу GPU-подов Prime Intellect — с жесткими лимитами расходов, которые вы контролируете.

Что это такое

Сервер MCP, который подключает Claude Code (или любой другой MCP-клиент) к вашей учетной записи Prime Intellect. С его помощью агент может:

• 🔍 Найти самый дешевый GPU-под, соответствующий вашим требованиям

• 💸 Запросить цену до списания средств

• 🛒 Выделить под (только после того, как вы подтвердите confirm=True)

• 🖥️ Подключиться по SSH (строка подключения передается собственному инструменту Bash агента)

• 🛑 Завершить работу пода, когда задача выполнена — и громко предупредить, если вы забудете это сделать

Создано для одного сценария: сказать Claude: «арендуй самый дешевый H100, запусти мой скрипт обучения, а затем выключи его» и не проснуться с счетом на $400.

Установка за 60 секунд

Вам нужно сделать только это, чтобы начать арендовать GPU через Claude Code:

1. Получите API-ключ Prime Intellect

Нажмите здесь, чтобы создать ключ → установите разрешения:

Скопируйте ключ — он начинается с pit_….

2. Добавьте сервер в Claude Code

Откройте ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) или файл .mcp.json вашего проекта и вставьте:

{
  "mcpServers": {
    "prime-intellect": {
      "command": "uvx",
      "args": ["prime-intellect-mcp"],
      "env": {
        "PRIME_API_KEY": "pit_PASTE_YOURS_HERE",
        "PRIME_MAX_HOURLY_USD": "5",
        "PRIME_MAX_TOTAL_USD": "40"
      }
    }
  }
}

Это всё. Перезапустите Claude Code и спросите: «Какие GPU доступны прямо сейчас дешевле $1/час?»

Нет uvx? Установите его с помощью curl -LsSf https://astral.sh/uv/install.sh | sh (или brew install uv). Это однострочный установщик для менеджера пакетов uv, и вам больше никогда не придется управлять виртуальными окружениями.

✨ Добавьте SSH (опционально, +2 мин) — необходимо, чтобы Claude мог запускать код на поде

Сервер выше уже может выделять, проверять и завершать работу подов. Но чтобы Claude Code мог подключиться по SSH к работающему поду и выполнять на нем команды, Prime Intellect должен знать публичный SSH-ключ вашей машины.

3. Найдите или создайте SSH-ключ на вашей машине

ls ~/.ssh/*.pub          # if you have id_ed25519.pub or similar, you're set
# otherwise:
ssh-keygen -t ed25519 -C "you@example.com"   # press Enter through the prompts

4. Зарегистрируйте публичный ключ в Prime Intellect

cat ~/.ssh/id_ed25519.pub    # or whichever .pub file you have

Скопируйте вывод (одна строка, начинающаяся с ssh-ed25519 …), затем вставьте его в форму Add SSH key на странице app.primeintellect.ai/dashboard/ssh-keys.

Это всё. Будущие поды будут содержать ваш публичный ключ в authorized_keys, и инструмент Bash в Claude Code сможет подключаться по SSH напрямую:

ssh ubuntu@<pod-ip-from-pod_status> "nvidia-smi"

Появится в v0.2: инструмент MCP register_ssh_key, который выполняет шаг 4 прямо из Claude (без посещения браузера). Следите за трекером задач.

Что теперь может делать Claude (9 инструментов)

Безопасность: ничего не выделяется без подтверждения

Три уровня защиты в порядке очереди:

1. Сначала расчет. pod_quote возвращает цену + 60-секундный токен. Никаких побочных эффектов. Сумма в долларах теперь находится в контексте агента.

2. Явное подтверждение. pod_create (и pod_terminate) требует confirm=True. Без этого вы получите только предварительный просмотр (dry-run).

3. Жесткие лимиты через переменные окружения. PRIME_MAX_HOURLY_USD блокирует любой под выше этой ставки. PRIME_MAX_TOTAL_USD блокирует любой под, если (ставка × макс_время_жизни_часов) превышает бюджет. Баланс кошелька также проверяется. Ни один из этих лимитов не может быть переопределен аргументами инструментов — они считываются при каждом вызове.

Значения по умолчанию: PRIME_MAX_HOURLY_USD=5, PRIME_MAX_TOTAL_USD=40. Установите их в блоке env вашего конфигурационного файла.

Каждый вызов pod_create / pod_terminate записывается в формате JSON в файл ~/.prime-intellect-mcp/audit.log, поэтому у вас есть полная история того, что агент делал с вашими деньгами.

Примеры промптов (вставьте их в Claude Code)

List the cheapest 1×H100 pods available right now. Show me the top 3 by hourly price.

Quote a 1×A100 80GB with 100GB disk, 8 vCPU, 64GB RAM. Don't provision yet —
just show me what it would cost.

I need to fine-tune a 7B model overnight. Find the cheapest 1×H100 with 200GB
disk, max $40 total budget, max 12 hours. Provision it, give me the SSH command,
and remind me to terminate when I'm done.

Check if I have any running pods I forgot about and show me their hourly cost.

Terminate pod abc123. Confirm before doing it.

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

Либо ваша конфигурация Claude Code не подхватила блок env, либо вы ввели PRIME_API_KEY как другую переменную. Проверьте с помощью:

$ env | grep PRIME

в той же оболочке, из которой запускается Claude Code, или вставьте ключ напрямую в JSON-блок env (вместо использования ${PRIME_API_KEY}).

Агент выбрал под, превышающий ваш жесткий лимит. Либо:

• Выберите более дешевый GPU (фильтр региона в list_availability часто показывает более дешевые варианты по ценам сообщества), либо

• Увеличьте PRIME_MAX_HOURLY_USD в вашей конфигурации и перезапустите Claude Code.

Расчеты действуют 60 секунд; агент слишком долго ждал между pod_quote и pod_create. Просто вызовите pod_quote снова — это бесплатно.

Выделение еще не завершено. Под запущен, но все еще выполняет скрипт установки. Вызовите pod_status(pod_id, wait_for_ssh=True), и он будет ждать (опрашивая каждые 5 секунд), пока SSH не станет доступен.

Вы не сообщили Prime Intellect свой публичный ключ (или под был выделен до того, как вы его зарегистрировали). Решение:

1. Убедитесь, что ваш публичный ключ зарегистрирован на app.primeintellect.ai/dashboard/ssh-keys.

2. Пересоздайте под — authorized_keys пода устанавливается в момент создания, поэтому существующие поды не подхватят ключи, зарегистрированные позже.

3. Если ваш приватный ключ защищен парольной фразой, выполните ssh-add --apple-use-keychain ~/.ssh/your_key один раз на macOS, чтобы агент в дальнейшем разблокировал его автоматически.

Пополните баланс на app.primeintellect.ai/wallet и попробуйте снова.

Почему еще один сервер?

На PyPI есть prime-mcp-server 0.1.2. Это простой прототип; данный проект не является его форком. Отличия для автономного использования:

Локальная разработка

git clone https://github.com/kvrancic/prime-intellect-mcp
cd prime-intellect-mcp
uv sync
uv run pytest -m "not live"        # 32 fast tests, no network, no spend
uv run ruff check .
uv run mypy src

Тест в реальном времени (выделяет самый дешевый доступный GPU, запускает nvidia-smi, завершает работу; расход ~$0.05):

PRIME_API_KEY=pit_... PRIME_LIVE_TEST=1 PRIME_LIVE_MAX_HOURLY=0.60 \
PRIME_MAX_HOURLY_USD=0.60 PRIME_MAX_TOTAL_USD=2.00 \
uv run pytest tests/test_smoke_live.py -v -s

Дорожная карта

• v0.2 — инструмент MCP register_ssh_key (отказ от шага в дашборде), песочницы (SDK prime-sandboxes), Центр окружений

• v0.3 — Опциональный демон автозавершения (серверное принудительное соблюдение max_lifetime_hours); телеметрия затрат

• v1.0+ — Хостинг/OAuth развертывание, когда Prime Intellect выпустит OAuth; отправка в каталог коннекторов Anthropic

Благодарности

• Prime Intellect за Python SDK prime, который выполняет 90% работы

• MIT 6.8610 (Advanced NLP) за кредиты Prime Intellect, которые сделали тестирование возможным

• Anthropic за MCP

• FastMCP за фреймворк

Лицензия

MIT — см. LICENSE.

Участие в разработке

Приветствуются сообщения об ошибках и PR. Пожалуйста, выполните uv run pytest -m "not live" и uv run ruff check . перед отправкой.