Netrun

netrun-mcp

将网站和 Telegram 机器人发布到 Netrun——从编辑器上传一个文件夹，即可获得 URL。

将 Netrun 连接到你的 AI 编辑器，然后只需说：“发布这个机器人”。Agent 会上传你的代码文件夹并返回链接。MCP 是将外部服务连接到 AI 编辑器的通用方式。连接 Netrun 后，你只需在聊天中告诉 Agent 想让项目上线：它会上传代码文件夹；如果代码需要令牌，就会向你索取；然后等待构建完成并提供链接。支持 Cursor、Claude Code、Codex、Claude Desktop、VS Code 和 Windsurf，也支持直接在浏览器中使用 ChatGPT 和 Claude。

将这个机器人发布到 Netrun

我修好了问候语——更新项目

机器人为什么没反应？检查日志

更改机器人令牌并重启

设置（约 1 分钟）

1. 在 netrun.io 登录 → MCP（https://netrun.io/mcp）→ 创建访问密钥。
2. 连接你的编辑器。MCP 页面会提供一个已填入密钥的现成按钮或命令；通用配置如下：

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

• Cursor — 在 MCP 页面点击 Add to Cursor，或将上述 JSON 放入 ~/.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 — 将上述 JSON 放入 MCP 服务配置中。

必须安装 Node.js——AI 编辑器通常自带它。

在浏览器中使用 ChatGPT、Claude——无需安装，无需密钥

Netrun 也可作为远程 MCP 服务运行：https://api.netrun.io/v1/mcp（Streamable HTTP，OAuth 登录）。在聊天设置中打开连接（Connectors 或 Apps），添加一个自定义连接并填写此地址，然后点击 Connect。通过电子邮件登录 Netrun——无需密钥。ChatGPT 仅允许付费方案使用自定义连接——请在设置中开启开发者模式。Claude 的所有方案均支持自定义连接，免费方案也支持。Agent 会直接从对话中获取代码；发布包含多个文件的大型项目时，使用编辑器会更方便。

Agent 能做什么

工具	功能
netrun_publish	上传项目文件夹并将其上线——可以是新项目，也可以是现有项目的新版本。自动检测技术栈（Python、Node、Go、Rust、PHP、静态 HTML、Docker、docker-compose），询问缺少的密钥，等待构建完成，并返回 URL 或失败原因。
netrun_status	查看项目是否正在运行、项目 URL、阻碍项目运行的因素、已设置的密钥，以及上次发布失败的原因。
netrun_logs	查看应用输出的最后几行——机器人没有反应时，首先应检查这里。
netrun_set_secrets	将令牌和 API 密钥保存为环境变量（加密存储），并重新发布项目，让应用使用这些变量。
netrun_link	决定项目是否获得公开的 HTTPS 地址——例如，我们将一个 webhook 机器人当作后台程序运行时。重新发布项目；如果应用能响应来自互联网的请求，就会显示链接。
netrun_domains	将你自己的域名指向网站，并检查注册商设置是否已生效。在生效前，它会显示需要添加的记录。
netrun_control	启动、停止或重启项目。
netrun_list_projects	列出账户中的所有项目及其 URL 和状态。
netrun_whoami	查看方案、可用项目数量，以及机器人剩余的免费运行时间。

明确不能做的事

• Agent 不能付款、续订方案或购买名额——这些操作需要你在控制面板中完成。
• 它也不能删除项目或持久化存储中的文件——任何不可逆操作都由你掌控。
• 如果代码需要令牌或密码，Agent 会在发布前询问你——绝不会编造这些值。
• 访问密钥只保存在你的编辑器配置中，已连接的聊天会显示在控制面板中——你可以随时在那里撤销访问。

工作原理

此软件包是一个轻量级中转工具：它会压缩文件夹（遵循 .gitignore），使用你的密钥将其发送到 Netrun API，并请求状态和日志。构建、运行、HTTPS 和地址均由 Netrun 处理。

环境变量：NETRUN_API_KEY（必需）、NETRUN_API_URL（默认值为 https://api.netrun.io/v1）、NETRUN_APP_URL（默认值为 https://netrun.io）。

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

MIT