Server4Agent

Server4Agent

为你的 AI 助手提供构建项目的服务。它会编写代码、运行代码，并将每个应用发布到可访问的 URL。

Server4Agent 是一个远程 MCP 服务。将它连接到你的 AI 助手，然后让助手创建网页、网站、应用、API、机器人或定时任务。助手会获得一个用于构建项目的服务，在那里编写并运行代码，再为每个项目发布专属的可访问 URL。对话结束后，进程仍会继续运行，因此后端和机器人会保持在线。

你无需在自己的设备上安装或运行任何东西。该服务托管在 https://mcp.server4agent.com，此代码仓库则在 MCP Registry 中收录了它。

连接

• 端点： https://mcp.server4agent.com
• 传输方式： 可流式 HTTP
• 登录： 使用动态客户端注册的 OAuth 2.1，或将 API 密钥作为承载令牌发送

你需要一个 Server4Agent 账户：https://www.server4agent.com

VS Code 和 GitHub Copilot

在 Extensions 视图的 MCP 服务库中安装 Server4Agent（搜索 @mcp Server4Agent），或将它添加到 .vscode/mcp.json：

{
  "servers": {
    "server4agent": {
      "type": "http",
      "url": "https://mcp.server4agent.com"
    }
  }
}

启动服务后，VS Code 会打开浏览器供你登录。无需复制密钥，也可以从控制面板撤销登录。之后，Copilot Chat 的 Agent 模式即可使用这些工具。

GitHub Copilot CLI

在控制面板中创建 API 密钥，将其导出为 SERVER4AGENT_API_KEY，然后将该服务添加到 ~/.copilot/mcp-config.json：

{
  "mcpServers": {
    "server4agent": {
      "type": "http",
      "url": "https://mcp.server4agent.com",
      "headers": { "Authorization": "Bearer ${SERVER4AGENT_API_KEY}" }
    }
  }
}

其他 MCP 主机

将 https://mcp.server4agent.com 添加为远程 MCP 服务。支持 OAuth 的主机会打开浏览器供你登录，无需进行其他设置。对于不支持 OAuth 的主机或 CI，请通过 Authorization: Bearer <key> 发送 API 密钥，并将密钥保存在环境变量中，而不是提交到代码仓库的配置文件里。

其他应用的设置方法：https://www.server4agent.com/integrations

使用方法

用自然语言提出请求。例如：

• “为我的面包店制作一个落地页并发布到网上。”
• “构建一个 API，将上传的 CSV 转换为 JSON，并把 URL 发给我。”
• “每小时检查一次我们的网站，并记录网站宕机的时间。”
• “我的服务上运行着什么？这个月我花了多少钱？”

它的工作方式：

• 服务是一个按规格配置的计算盒子（小、中或大），用于存放项目。一个服务可以容纳多个项目。
• 项目是一个文件夹和一个应用，并拥有自己的 URL：<slug>.apps.server4agent.com。项目在通过 deploy 部署之前都是私有的。
• 你的助手可以自行编写文件，也可以将目标交给在服务上运行的 Agent（start_build、prompt），这会消耗账户的 AI 预算。
• 会删除或覆盖内容的工具会标记为破坏性操作，因此主机可以在运行前征求你的同意。

工具

共 38 个工具。[read-only] 表示不会写入；[destructive] 表示可能删除或覆盖。

服务

服务是一个按规格配置的计算盒子。项目存放在其中，并共享其资源。

• create_server：配置一个指定规格的服务盒子。
• list_servers [read-only]：列出你的服务及其规格、类型、状态、项目共享设置和当前项目数量。
• get_server [read-only]：获取服务的规格、类型、状态、容量、项目数量和项目共享设置。
• update_server [destructive]：更新服务的昵称、区域，或项目之间的可见范围。
• control_server [destructive]：暂停服务（停止）、恢复服务（启动）或重启服务。
• delete_server [destructive]：拆除服务及其上的所有项目。
• get_usage [read-only]：查看账户的 AI 支出和预算：本计费周期已花费的金额、套餐包含的额度、预算上限（如有），以及新任务是否已被阻止（含原因）。

项目

项目是服务器中的一个工作区和应用，有自己的 slug 和 URL。新项目默认为私有：只有设为公开后，URL 才会提供服务。

• list_templates [read-only]：列出可用的项目起始模板。
• create_project：在服务器上创建一个项目：用于托管一个网页、网站、应用、API 或机器人，并拥有自己的 URL：<slug>.apps.server4agent.com。
• list_projects [read-only]：列出项目。
• get_project [read-only]：获取单个项目的信息：名称、slug、描述、公开 URL、监听端口、运行计划和时间戳。
• update_project [destructive]：重命名项目、更新描述、更改可见性、链接访问权限或生命周期，或修正运行计划。
• init_project：启动或继续初始化从 Git/归档源创建的项目：服务器上的 Agent 会安装依赖、启动应用并确认其能够响应。
• export_project：将项目打包成可移植的捆绑包，并返回有时效的下载链接。
• import_project：根据 export_project 生成的捆绑包，在服务器上重新创建项目，可在此处或其他 Server4Agent 部署中导入。
• cleanup_project [destructive]：任务完成后清理临时项目。
• delete_project [destructive]：删除项目。

密钥

用于服务器和项目的环境变量。密钥值只可写入：任何工具都不会读取已保存的值。

• set_secret [destructive]：在账户中创建或更新密钥（环境变量，键 → 值）。
• list_secrets [read-only]：列出账户的密钥：键、备注，以及每个密钥绑定的位置（服务器/项目）。
• attach_secret [destructive]：将密钥绑定到某个范围，以便该范围内的运行将其作为环境变量使用。
• delete_secret [destructive]：删除密钥及其所有绑定。

Agent 运行时

启动并保持应用运行，将工作委派给服务器上运行的 Agent，或自行操作 Shell。

• start_app [destructive]：启动项目的应用并使其持续运行：在文件写入后，让项目上线的步骤。
• prompt：向服务器上的 Agent 发送自由格式提示词。
• exec [destructive]：在服务器上运行 Shell 命令并返回其输出。
• get_run [read-only]：获取一次运行的状态、最新进度说明、Agent 的最终回复，以及它在工作区中所做的更改（提交、分支、文件）。
• get_logs [read-only]：读取服务器上最新的日志尾部内容：每个项目进程写入的日志文件各占一条记录（每个长期运行的进程都会将内容追加到其项目文件夹中的 .server4agent/<name>.log）。

文件工作区

无需 Agent 时，可直接读取和写入项目文件。

• list_files [read-only]：列出服务器工作区中的路径。
• read_file [read-only]：读取服务器工作区中的文件。
• write_file [destructive]：写入或覆盖服务器工作区中的文件。
• delete_file [destructive]：删除服务器工作区中的文件。
• get_download_url：生成一个有时效的链接，用于下载服务器工作区中的单个文件；例如，生成报告或转换文件后，可将此 URL 返回给用户，而不是返回原始内容。

构建和部署

通过目标指令让 Agent 构建项目；部署则会将运行中的项目上线。

• start_build：让服务器上的 Agent 根据自然语言目标构建网页、网站、应用或 API。
• get_build [read-only]：获取构建状态。
• deploy：将项目部署到其公开的线上 URL：<slug>.apps.server4agent.com，这是让网页、网站、应用或 API 上线的最后一步。

自我调优

将评估报告反馈到 Agent 自身的代码中，让它修复报告中发现的问题。

• start_tuning：根据评估平台的报告修复 Agent。
• get_tuning_session：获取调优运行的状态及其背后的 Agent 运行。
• list_tuning_sessions [read-only]：按时间倒序列出此账户的调优运行。
• report_tuning_result：告知评估平台调优运行修改了什么，以及修复后的构建可从何处访问。

每个工具的参数及详细示例都列在 Agent Skill 中，地址为 https://www.server4agent.com/skill.md；连接后也可在每个工具的 JSON 架构中查看。

链接

• 网站：https://www.server4agent.com
• 连接其他应用：https://www.server4agent.com/integrations
• 问题咨询：[email protected]