Netrun

io.netrun由 netrun.io 发布官方发布者v0.4.0更新于 Oct 30, 2026

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

已验证Streamable HTTP可网页运行云端与基础设施开发者工具沟通与协作

服务详情

标识符: io.netrun/netrun
传输: Streamable HTTP
运行时: Web executable
信任: Verified
发布于: Oct 29, 2026

安全提示

MCP 服务会接收对话中的工具调用请求，并可能执行外部操作。启用前请先了解该服务能做什么，并只授予它所需的权限。

注册中心已验证此服务的命名空间属于 netrun.io，且该域名同时运行其端点。这可以确认发布者，但并不代表该服务的工具是安全的。

SourceWeft 的检查只涵盖条目是否完整、端点是否响应；不审查服务器的代码，也不审查其工具的行为。

在 README 中添加徽章

向读者展示该 MCP 服务已收录于 SourceWeft，徽章链接到本页。

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

概览

AI 生成的概览

Netrun 让助手从编辑器部署网站和机器人（Telegram、Discord）：上传项目文件夹、等待构建并返回公开网址。

可以做什么: 发布与更新项目：上传文件夹、自动识别技术栈、等待构建并返回网址或失败原因
查看项目：列出账号下所有项目及其网址与状态，查看套餐、项目额度和剩余免费运行时间
排查问题：读取状态（阻塞原因、已保存的密钥名称、上次发布失败原因）和应用日志最后几行
管理密钥：把令牌和 API 密钥保存为加密的环境变量并重新发布
域名与链接：返回自定义域名需添加的 DNS 记录、校验记录，并为项目申请公开 HTTPS 地址
控制运行：启动、停止或重启项目
适用场景: 适合希望让助手把小型网站、API 或聊天机器人上线而不必自己管理服务器的场景，也适合排查已部署应用为何无响应或失败。代码改动后更新已有项目时同样方便。
运行要求: 远程方式：Streamable HTTP 端点，通过邮箱 OAuth 登录，无需密钥（ChatGPT 自定义连接需付费套餐并开启开发者模式）。本地方式：需安装 Node.js，通过 npx 运行 npm 包，并设置环境变量 NETRUN_API_KEY（在 Netrun 的 MCP 页面创建的个人访问密钥）。需要 Netrun 账号；自定义域名需付费套餐。

安装前请注意

助手会把项目文件夹上传到 Netrun 的服务器，请先确认文件夹内容。提供的密钥会加密存储且只写，但仍会经由助手传递。发布、重启和修改密钥会改变线上状态；构建需要数分钟，应避免反复发布。助手无法付款、续订套餐或删除项目，自定义域名需付费套餐。免费套餐的机器人在运行时间用尽后会停止。

安装

在 SourceWeft 中

打开控制台中的 Netrun，将其添加到工作区。
连接所需的凭据。它们会被私密存储，绝不会在公开页面上展示。
为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.netrun%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).

Registry: io.netrun/netrun
Source: https://github.com/netrun-io/netrun-mcp

MIT

来源：README.md，提交 2581702

工具

netrun_whoami

Netrun account

The plan, how many projects are available and how much free running time bots have left.

无需输入参数。

netrun_list_projects

List Netrun projects

All projects of the account with URLs and state.

无需输入参数。

netrun_status

Project status

Is the project running, its URL, what blocks it, which secrets are already set and why the last publish failed. It also lists the names of the secrets already saved; their values are never returned.

输入参数project_id必填

netrun_logs

Project logs

Last lines of the application output — the first place to look when a bot goes silent. Most failures name their cause in the last lines.

输入参数linesproject_id必填

netrun_publish

Publish to Netrun

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. A new project takes a name; an existing one is updated by project_id. When the code needs secrets that are not set yet, the result is needs_secrets with their names, and values go in “secrets”. A build takes 1-5 minutes.

输入参数namepath必填waitcommentsecretsproject_idskip_secretswait_seconds

netrun_set_secrets

Set project secrets

Saves tokens and API keys as environment variables (stored encrypted) and re-publishes so the app picks them up. Values are write-only and are never returned.

输入参数filepublishsecrets必填project_id必填

netrun_domains

Custom domain

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. The result lists the DNS records to add at the registrar; action "check" verifies them. Records take minutes to hours to spread. Custom domains need a paid plan and a website (bots have no address). Removing a domain is only available in the dashboard.

输入参数actiondomainproject_id必填

netrun_link

Public 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 guesses from the code whether a project needs an address, and a webhook bot or an API can look like a background program. needed=true gives the project a URL, needed=false removes it; the choice survives later code updates. The project is re-published (a short restart). The link appears only if the app listens on 0.0.0.0 on the port from the PORT environment variable; otherwise the project keeps running in the background without a link. The URL is not registered with the bot platform automatically (for Telegram that is setWebhook).

输入参数waitneeded必填project_id必填wait_seconds