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).