Netrun

io.github.fadeynotchenko由 GitHub 帳號 fadeynotchenko 發布v0.3.1更新於 Oct 27, 2026

Publish websites and Telegram bots to Netrun — upload a folder from your editor, get a URL

發布方自己的服務：Netrun

已驗證Streamable HTTP可網頁執行雲端與基礎設施開發者工具溝通與協作

服務詳細資訊

識別碼: io.github.fadeynotchenko/netrun
傳輸: Streamable HTTP
執行環境: Web executable
信任: Verified
發布於: Sep 22, 2026

安全提示

MCP 服務會接收對話中的工具呼叫請求，並可能執行外部操作。啟用前請先了解該服務能做什麼，並只授予它所需的權限。

註冊中心已驗證此條目所屬的 GitHub 帳號 fadeynotchenko。這並不表明該帳號就是產品方。

SourceWeft 的檢查只涵蓋條目是否完整、端點是否回應；不審查伺服器的程式碼，也不審查其工具的行為。

在 README 中新增徽章

向讀者展示該 MCP 服務已收錄於 SourceWeft，徽章連結到本頁。

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.fadeynotchenko%2Fnetrun.svg)](https://sourceweft.com/mcp/io.github.fadeynotchenko%2Fnetrun?utm_source=readme&utm_medium=badge)

概覽

AI 產生的概覽

Netrun 讓助理把程式碼資料夾發布成託管的網站或 Telegram 機器人，並查看狀態、日誌、密鑰、網域與重新啟動服務。

可以做什麼: 發布專案資料夾，作為新專案或新版本，自動辨識技術堆疊、等待建置並回傳網址或失敗原因
查看專案執行狀態、網址、阻擋原因、已設定的密鑰以及上次發布失敗的原因
讀取應用程式輸出的最後幾行日誌
把權杖與 API 金鑰存成加密的環境變數並重新發布
開啟公開 HTTPS 位址、把自有網域指向網站並檢查網域註冊商的記錄是否生效
啟動、停止或重新啟動專案，列出帳號下所有專案，查看方案與剩餘免費執行時數
適用情境: 適合在 AI 編輯器中開發小型網站或 Telegram 機器人，並希望助理直接在對話中完成部署並回傳連結的情境。也適合快速排查機器人沒有回應、網域是否生效等維運問題。
執行需求: 可使用遠端端點並以電子郵件 OAuth 登入，或在本機以 Node.js 執行 npm 套件 netrun-mcp。本機方式需要 Netrun 帳號，並在 NETRUN_API_KEY 填入個人存取金鑰，同時需要連線至 Netrun API 的網路。ChatGPT 的自訂連線需要付費方案並開啟開發人員模式。

安裝前請注意

存取金鑰是存放在編輯器設定中的憑證，外洩後應在控制台撤銷。發布會把程式碼資料夾上傳到 Netrun，儲存的密鑰也會傳送並由該服務保存。助理可以啟動、停止、重新啟動與重新發布專案，會改變線上部署；它不能付款、續訂方案或刪除專案。

安裝

在 SourceWeft 中

開啟儀表板中的 Netrun，將其新增到工作區。
連接所需的憑證。它們會被私密儲存，絕不會在公開頁面上展示。
為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.fadeynotchenko%2Fnetrun/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。客戶端會在首次連接時完成 OAuth 登入。

{
  "mcpServers": {
    "netrun": {
      "type": "http",
      "url": "https://api.netrun.io/v1/mcp"
    }
  }
}

README

netrun-mcp

Publish websites and Telegram bots to Netrun — upload a folder from your editor, get a URL.

Connect Netrun to your AI editor and just ask: “publish this bot”. The agent uploads your code folder and sends back the link. MCP is the common way to connect external services to AI editors. With Netrun connected, you tell the agent in chat that you want the project online: it uploads the code folder, asks for a token if the code needs one, waits for the build and gives you the link. Works in Cursor, Claude Code, Codex, Claude Desktop, VS Code and Windsurf, and in ChatGPT and Claude right in the browser.

Publish this bot to Netrun

I fixed the greeting — update the project

Why is the bot silent? Check the logs

Change the bot token and restart

Setup (one minute)

Sign in at netrun.io → MCP (https://netrun.io/mcp) → create an access key.
Connect your editor. The MCP page gives you a ready button or command with the key already inside; the generic form is:

json

{  "mcpServers": {    "netrun": {      "command": "npx",      "args": ["-y", "netrun-mcp@latest"],      "env": {        "NETRUN_API_KEY": "nru_…"      }    }  }}

{  "mcpServers": {    "netrun": {      "command": "npx",      "args": ["-y", "netrun-mcp@latest"],      "env": {        "NETRUN_API_KEY": "nru_…"      }    }  }}

Cursor — click Add to Cursor on the MCP page, or put the JSON above into ~/.cursor/mcp.json.
Claude Code — claude mcp add netrun -s user -e NETRUN_API_KEY=nru_… -- npx -y netrun-mcp@latest
Codex — codex mcp add netrun --env NETRUN_API_KEY=nru_… -- npx -y netrun-mcp@latest
Claude Desktop, VS Code, Windsurf — the JSON above in the MCP servers config.

Node.js has to be installed — AI editors usually ship with it.

ChatGPT, Claude in the browser — no install, no key

Netrun also runs as a remote MCP server: https://api.netrun.io/v1/mcp (Streamable HTTP, OAuth sign-in). In the chat settings open connections (Connectors or Apps), add a custom one with this address and press Connect. You sign in to Netrun by email — no key needed. ChatGPT allows custom connections on paid plans — turn on developer mode in the settings. Claude allows them on every plan, one on the free plan. The agent takes the code right from the conversation; a large multi-file project is easier to publish from an editor.

What the agent can do

Tool	What it does
`netrun_publish`	Uploads a project folder and puts it online — a new project or a new version of an existing one. Detects the stack (Python, Node, Go, Rust, PHP, static HTML, Docker, docker-compose), asks for missing secrets, waits for the build and returns the URL or the failure reason.
`netrun_status`	Is the project running, its URL, what blocks it, which secrets are already set and why the last publish failed.
`netrun_logs`	Last lines of the application output — the first place to look when a bot goes silent.
`netrun_set_secrets`	Saves tokens and API keys as environment variables (stored encrypted) and re-publishes so the app picks them up.
`netrun_link`	Decides whether the project gets a public HTTPS address — for example a webhook bot we took for a background program. Re-publishes the project; the link appears if the app answers requests from the internet.
`netrun_domains`	Points your own domain at the site and checks whether the registrar settings have taken effect. Until they have, it shows which records to add.
`netrun_control`	Start, stop or restart a project.
`netrun_list_projects`	All projects of the account with URLs and state.
`netrun_whoami`	The plan, how many projects are available and how much free running time bots have left.

What it deliberately cannot do

The agent cannot pay, renew a plan or buy places — you do that in the dashboard.
It cannot delete projects or files from persistent storage either — anything irreversible stays with you.
If the code needs a token or a password, the agent asks you before publishing — it never makes values up.
The access key lives only in your editor config, and a connected chat is listed in the dashboard — you can revoke either there at any time.

How it works

This package is a thin courier: it zips the folder (honouring .gitignore), sends it to the Netrun API with your key, and asks for status and logs. Building, running, HTTPS and addresses all happen on Netrun.

Environment variables: NETRUN_API_KEY (required), NETRUN_API_URL (default https://api.netrun.io/v1), NETRUN_APP_URL (default https://netrun.io).