ComputeNexa

io.github.computenexa-gpuInfrastructure由 GitHub 帳號 computenexa-gpuInfrastructure 發布v0.1.0更新於 Nov 1, 2026

Find, launch and stop private GPUs on ComputeNexa, with a quote before anything is charged.

已驗證STDIO僅桌面雲端與基礎設施金融

概覽

AI 產生的概覽

讓助理在 ComputeNexa 上瀏覽、啟動、延長與停止私有 GPU 機器，並在扣款前先提供報價。

可以做什麼
  • 查看 API 金鑰身分、團隊餘額、GPU 上限與權限
  • 列出 GPU 的即時每小時價格與庫存，以及可執行的軟體與模型
  • 列出機器並檢視單一機器的連線方式、剩餘時間與費用
  • 查看花費、GPU 小時數、已完成工作階段與已儲存專案
  • 啟動、延長或自動續約機器，以及停止機器
  • 建立 Endpoint 並取得其金鑰
適用情境
適合在 ComputeNexa 租用 GPU 的使用者，希望助理在對話中比較價格與庫存、以指定軟體啟動機器，或查看並停止執行中的機器。
執行需求
透過 uvx 以 stdio 在本機執行，需先安裝 uv。需要 ComputeNexa API 金鑰，放在 CNX_API_KEY 中，可在儀表板建立為僅檢視或可啟動停止兩種權限。可選 CNX_MCP_MAX_LAUNCH_USD 限制單次呼叫花費（預設 25）。需要連線至 ComputeNexa API 的網路。
安裝前請注意
啟動、延長與保持執行會從團隊預付餘額扣款；伺服器先回傳報價，需再次確認呼叫，助理不應自行確認。stop_machine 無法復原，且會刪除專案以外的檔案。Endpoint 金鑰可存取你自己的伺服器，僅在要求時顯示。API 金鑰保存在本機設定中，不會出現在工具結果裡。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 ComputeNexa，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

ComputeNexa MCP server

Let your AI assistant find, launch and stop private GPUs on ComputeNexa. Ask it "Which GPUs with 48 GB or more are in stock?", "Launch the cheapest one with Data Science for two hours" or "Stop it": it uses your team's API key, shows you what each launch costs, and only spends money after you agree.

Works with Claude Desktop, Claude Code, Cursor, VS Code and other assistants that support the Model Context Protocol. It runs on your computer and talks to the ComputeNexa API; your key stays in your own settings.

Set up

  1. In the ComputeNexa dashboard, open API keys and create a key:
    • Look only to browse GPUs, machines and spending;
    • Launch and stop to also launch, extend and stop machines.
  2. Install uv (it runs the server with uvx, no separate install needed).
  3. Add the server to your assistant (below), with your key as CNX_API_KEY.

Claude Code

bash
claude mcp add --env CNX_API_KEY=cnxk_... --transport stdio computenexa -- uvx computenexa-mcp

Add --scope user to use it in every project.

Claude Desktop

Settings → Developer → Edit config (claude_desktop_config.json):

json
{  "mcpServers": {    "computenexa": {      "command": "uvx",      "args": ["computenexa-mcp"],      "env": { "CNX_API_KEY": "cnxk_..." }    }  }}

Cursor

~/.cursor/mcp.json (every project) or .cursor/mcp.json (one project): the same mcpServers entry as Claude Desktop.

VS Code

.vscode/mcp.json; VS Code asks for the key once and keeps it out of the file:

json
{  "inputs": [    { "type": "promptString", "id": "cnx-key", "description": "ComputeNexa API key", "password": true }  ],  "servers": {    "computenexa": {      "type": "stdio",      "command": "uvx",      "args": ["computenexa-mcp"],      "env": { "CNX_API_KEY": "${input:cnx-key}" }    }  }}

What it can do

ToolWhat it doesKey
whoamiYour email, team, balance, GPU limit and the key's permissionsany
list_gpusGPUs with live prices and stock, cheapest first; filter by app, region, memoryany
list_appsThe apps a GPU starts with, their models, and what's installedany
list_machines · get_machineYour machines; how to connect (SSH, browser apps, API or endpoint address)any
get_usage · list_receiptsSpending and GPU-hours; finished sessions and their costany
list_projects · list_endpointsSaved projects; Endpoints and the machine each points atany
launch_machineLaunch a GPU (quote first, then launch when you agree)launch and stop
extend_machineAdd time (quote first)launch and stop
set_keep_runningRenew a machine automatically until stopped (quote first)launch and stop
stop_machineEnd a machine now; unused time is refundedlaunch and stop
create_endpoint · get_endpoint_keyA stable HTTPS address for your own server; its keylaunch and stop

A look-only key only gets the read tools (the first six rows).

Safety

  • Nothing is charged without you. launch_machine, extend_machine and set_keep_running first return a quote, e.g. "NVIDIA RTX A6000 with the datascience app for 2 h: $1.44 charged now ($0.72/h); unused time is refunded if it stops early." Only a second call with confirm=true and the quoted total goes ahead; if the price went up in between, it's refused.
  • A limit per call: a launch, extension or keep-running renewal costing more than $25 is refused. Change it with CNX_MCP_MAX_LAUNCH_USD (in dollars) in the server's env. Your team's GPU limit and prepaid balance still apply on top.
  • Your API key never appears in a tool result. Endpoint keys are shown only when you create an endpoint or ask for its key.
  • Tools that spend money or end a machine are marked as such, so your assistant asks before using them.

Settings

Variable
CNX_API_KEYRequired. A ComputeNexa API key (cnxk_…)
CNX_MCP_MAX_LAUNCH_USDMost one call may spend, in US dollars. Default 25
CNX_API_URLOnly for testing against another ComputeNexa API

Develop

bash
uv syncuv run pytestuv run ruff check src tests

Built on the ComputeNexa Python SDK and the official MCP Python SDK.

Questions: [email protected] · Security issues: see SECURITY.md.

來源：README.md，提交 d0cf599

工具

15

whoami

Who am I

Who this server's API key acts as: email, team and role, the team's balance and GPU limit, and whether the key may launch and stop machines.

無需輸入參數。

list_gpus

List GPUs

GPUs with live prices (US dollars per GPU per hour) and stock, cheapest first.

輸入參數appregionmin_memory_gbinclude_sold_out

list_apps

List apps

The apps a GPU can start with (basic, datascience, chat, imagegen, modelapi, voice): what each is for, the models it offers and which model we recommend per GPU memory. Give `app` for the software installed.

輸入參數apppackage

list_machines

List machines

Your machines, newest first: state, GPU, app, price, time left and cost so far.

輸入參數limitwhole_teamactive_only

get_machine

Get a machine

One machine: its state, how to connect (SSH command, browser apps, API or endpoint address), time left, keep-running status and costs. Never its keys.

輸入參數machine_id必填

get_usage

Get usage

Spending and GPU-hours over the last N days, by GPU, app, day and project.

輸入參數days

list_receipts

List receipts

Finished sessions and what each cost in the end (charged minus refunded).

輸入參數dayslimit

list_projects

List projects

Saved projects (files restored into ~/work on machines launched with them) and their size.

無需輸入參數。

list_endpoints

List endpoints

Endpoints: stable HTTPS addresses for your own server on a machine's port 8000, and the machine each points at now. Never their keys.

無需輸入參數。

launch_machine

Launch a machine

Launch a GPU machine. Costs money: call first with confirm=false to get a quote (nothing happens), show it to the person, and only after they agree call again with the same arguments, confirm=true and expected_total_usd. The booked time is charged up front from the team's balance.

輸入參數app必填gpu必填hours必填labelmodelregionconfirmprojectendpointgpu_countexpected_total_usdkeep_running_hours

extend_machine

Extend a machine

Add time to a machine at the price it launched with. Costs money: quote first (confirm=false), then confirm=true with expected_total_usd once the person agrees.

輸入參數hours必填confirmmachine_id必填expected_total_usd

set_keep_running

Keep a machine running

Keep running: the machine renews itself `hours` at a time from the team's balance, at its launch price, until it's stopped. Turning it on spends money at every renewal: quote first, then confirm=true with expected_renewal_usd. Turning it off (hours=null) needs no confirmation.

輸入參數hours必填confirmmachine_id必填expected_renewal_usd

stop_machine

Stop a machine

End a machine now: stopped if running, cancelled with a full refund if still starting. Files outside a project are deleted; a project is saved first. Unused time is refunded. Can't be undone.

輸入參數machine_id必填

create_endpoint

Create an endpoint

A new Endpoint (owners and admins): a stable HTTPS address and key for your own server on port 8000, e.g. one per customer you serve. Launch machines for it with launch_machine(endpoint=...). Free. Its key is shown once here; get_endpoint_key shows it again.

輸入參數name必填

get_endpoint_key

Get an endpoint's key

An Endpoint's key (owners and admins). Only when the person asks for it: it gives access to their server.

輸入參數endpoint必填

版本歷史

1
  1. v0.1.0最新Nov 1, 2026

評分

已滿足適用檢查項的 90%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分
  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分