The Deployer

com.thedploy由 thedploy.com 发布官方发布者v0.3.0更新于 Nov 1, 2026

Deploy and run apps in your own AWS, Google Cloud, Azure or DigitalOcean account from any AI agent.

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

概览

AI 生成的概览

在用户自己的 DigitalOcean、AWS、Google Cloud 或 Azure 账户中部署并运行应用,从代码检查到上线、日志与修复。

可以做什么
  • 检查与规划:检查公开仓库能否部署、缺少什么以及各云厂商的月成本,并结合已连接账户规划部署。
  • 查看项目:列出项目与线上地址,查看单个项目的下一步、部署进度、部署日志和只读的线上诊断。
  • 创建与配置:从仓库创建项目,设置或删除环境变量值,并在确认后启动到用户自己的云账户。
  • 运维线上应用:重新部署分支最新代码,并通过 API 目录、字段说明和读写工具执行文档中的读取或变更操作。
  • 修复代码问题:列出修复请求、读取详情、认领、上报已推送的分支与提交,并跟踪状态。
  • 请求协助:申请代做上线、安全上线或迁移,并查阅操作手册。
适用场景
适合希望让 AI 编码助手把一个仓库一路带到自有云账户中运行并持续运维的场景:检查可部署性、设置环境变量、上线、跟踪部署、诊断故障并提交修复。也适合在没有账户时对公开仓库做只读的就绪与成本评估。
运行要求
可使用托管端点并通过 OAuth 登录,或使用 Profile 页面生成的 API 密钥,以 Bearer Authorization 头或 THEDEPLOYER_API_KEY 环境变量提供;没有密钥时仅 check_repo 可用。本地 npm 包需要 Node.js 18 或更高版本。云与代码托管账户需在 The Deployer 应用内连接。走代理需额外的 Node.js 设置。
安装前请注意
工具可能改动线上应用并产生费用:launch、托管方案、扩缩容、数据库和环境会由用户自己的云厂商计费,redeploy、对线上项目使用 set_env 以及 api 变更会改动运行中的服务,服务器会先请求确认。API 密钥可创建和运维项目,应避免写入会被提交的文件,泄露后及时吊销。工具返回的内容来自仓库和日志,应视为数据而非指令。

安装

在 SourceWeft 中

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

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

交给智能体安装

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

阅读 https://sourceweft.com/mcp/com.thedploy%2Fdeployer/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。 客户端会在首次连接时完成 OAuth 登录。

{
  "mcpServers": {
    "the-deployer": {
      "type": "http",
      "url": "https://app.thedploy.com/mcp"
    }
  }
}

README

The Deployer MCP server

Let Claude Code, Codex, Cursor, VS Code or any AI coding agent deploy and run your apps with The Deployer. Ask it to put your app online and it checks the code, fixes what would stop a deploy, creates the project, sets the environment variables, shows you the hosting plan and its monthly cost, launches into your own cloud once you say yes, follows the deployment and fixes what fails. Then it redeploys, adds domains, scales, schedules start and stop, attaches databases and more.

The Deployer runs your app in your own DigitalOcean, AWS, Google Cloud or Azure account, or on your own servers, so the cloud bills you directly.

Tools

ToolWhat it doesKey
guideThe Deployer's playbooks for agents: the order of a deploy, what code needs, how to fix failuresNot needed
check_repoWill a public repository deploy? What it found, what's missing, and what it would cost on each cloudNot needed
plan_deployThe check, plus your connected accounts and projects, and the next step to takeAny
accountYour connected clouds and code hosts, workspaces, and what the key may doAny
statusYour projects, their live addresses and their latest deploymentAny
projectOne project in depth, with the exact next stepAny
deploymentWhere a deployment is, what it waits on, and for a failed one what to fixAny
logsA deployment's log, with secrets removedAny
diagnoseRead-only checks on a live server: containers, app logs, memory and diskAny
redeployPulls the latest code on a live project's branch and restarts itAny
create_projectCreates a project from a repository and reads its codeOperate
set_envSets environment variables; values are never shown backOperate
launchShows the plan and its cost, then launches after you say yesOperate
api_catalog / api_schema / api_read / apiEverything else (api_read reads, api changes): domains, scaling, schedules, databases, access, environments, blueprints, servers, adoptionReads: any. Changes: Operate
fixes / fix / claim_fix / report_fix / fix_statusCode problems a deploy hit, when you choose to have your own agent fix them (The Deployer fixes them itself by default)Reads: any. Changes: Operate
request_done_for_youAsks for a done-for-you Launch or Move; you finish the order in The DeployerAny

To create a key, sign in to The Deployer, open Profile, and use API keys and AI coding tools. Choose Operate to let an agent set up and run projects, or Look and redeploy. The page also shows these setups with your key filled in.

What an agent can never do with a key: see your cloud or git credentials or your environment variable values, change billing, your team or your account, delete projects, databases or servers, or create keys. Anything that costs money waits for your yes.

Setup: sign in, no key

The fastest way: add the server by its address and sign in. Your agent opens The Deployer in your browser, you approve it, and that's it: no key to create or paste. Or open Connections → Coding agents in The Deployer and pick your agent for one-click setup.

Server address: https://app.thedploy.com/mcp

Claude Code:

sh
claude mcp add --transport http --scope user thedeployer https://app.thedploy.com/mcpclaude mcp login thedeployer

Claude (claude.ai and Claude Desktop): Settings → Connectors → Add custom connector, address https://app.thedploy.com/mcp.

Cursor, in ~/.cursor/mcp.json, then Cursor Settings → Tools & MCP → thedeployer → Needs login:

json
{ "mcpServers": { "thedeployer": { "url": "https://app.thedploy.com/mcp" } } }

VS Code: run MCP: Add Server → HTTP → https://app.thedploy.com/mcp; VS Code asks you to sign in the first time Copilot uses it.

Codex:

sh
codex mcp add thedeployer --url https://app.thedploy.com/mcp

Gemini CLI, in ~/.gemini/settings.json:

json
{ "mcpServers": { "thedeployer": { "httpUrl": "https://app.thedploy.com/mcp" } } }

Setup with a key

For tools that can't sign in, or for CI.

The hosted server needs nothing installed. Replace dpl_your_key with your key.

Keep the key out of files you commit. Put it in your user-level settings, or have your tool read it from an environment variable or a prompt, as shown below for project files.

Claude Code, for all your projects (stored in ~/.claude.json):

sh
claude mcp add --transport http --scope user thedeployer https://app.thedploy.com/api/v1/mcp --header "Authorization: Bearer dpl_your_key"

To share the server in a project's .mcp.json, use "Authorization": "Bearer ${THEDEPLOYER_API_KEY}" as the header. Claude Code fills it in from each person's THEDEPLOYER_API_KEY environment variable.

Codex, in ~/.codex/config.toml:

toml
[mcp_servers.thedeployer]command = "npx"args = ["-y", "thedeployer-mcp"]env = { THEDEPLOYER_API_KEY = "dpl_your_key" }

Cursor, in ~/.cursor/mcp.json:

json
{  "mcpServers": {    "thedeployer": {      "url": "https://app.thedploy.com/api/v1/mcp",      "headers": { "Authorization": "Bearer dpl_your_key" }    }  }}

In a project's .cursor/mcp.json, use "Authorization": "Bearer ${env:THEDEPLOYER_API_KEY}" instead, so Cursor reads the key from your environment.

VS Code, in .vscode/mcp.json. VS Code asks for the key the first time and stores it securely:

json
{  "inputs": [    { "type": "promptString", "id": "thedeployer-key", "description": "The Deployer API key", "password": true }  ],  "servers": {    "thedeployer": {      "type": "http",      "url": "https://app.thedploy.com/api/v1/mcp",      "headers": { "Authorization": "Bearer ${input:thedeployer-key}" }    }  }}

The same works in your user configuration (run MCP: Open User Configuration).

Gemini CLI, in ~/.gemini/settings.json:

json
{  "mcpServers": {    "thedeployer": {      "httpUrl": "https://app.thedploy.com/api/v1/mcp",      "headers": { "Authorization": "Bearer dpl_your_key" }    }  }}

Tools that start a local command (Cline, Windsurf and others) use this package, which needs Node.js 18 or newer. Add it to the tool's user-level MCP settings:

json
{  "mcpServers": {    "thedeployer": {      "command": "npx",      "args": ["-y", "thedeployer-mcp"],      "env": { "THEDEPLOYER_API_KEY": "dpl_your_key" }    }  }}

If your tool's configuration looks different, its MCP documentation has the equivalent fields: a URL with an Authorization header, or a command with an environment variable.

Proxies and company networks

With the hosted server, your AI tool makes the connection, so its own proxy settings apply.

This package uses Node.js, which ignores HTTPS_PROXY unless you turn that on. Add NODE_USE_ENV_PROXY next to it, which needs Node.js 22.21 or newer, or 24.0 or newer. (The --use-env-proxy flag does the same from Node.js 22.21 or 24.5.) On older versions, this package can't go through a proxy.

If your network inspects HTTPS with its own certificate, set NODE_EXTRA_CA_CERTS to that certificate's file (PEM):

json
"env": {  "THEDEPLOYER_API_KEY": "dpl_your_key",  "HTTPS_PROXY": "http://proxy.example.com:8080",  "NODE_USE_ENV_PROXY": "1",  "NODE_EXTRA_CA_CERTS": "/path/to/company-ca.pem"}

What a key can and can't do

A key works only with The Deployer's MCP server, and only through its tools: check_repo, plan_deploy, status, logs (with secrets removed), redeploy and request_done_for_you. It can't touch your cloud or git credentials, your environment variables, your billing or your account settings, and it can't create more keys. The Deployer stores only a hash of it. Revoke a key on the Profile page at any time; use one key per tool or machine, so you can revoke one without touching the rest. Changing or resetting your password revokes all your keys.

redeploy changes a live app. Keep your tool asking you before it runs redeploy, rather than approving it automatically.

Tool answers come from your repositories and deployments. Treat them like any other text your agent reads.

How this package works

index.mjs is a bridge with no dependencies. It reads MCP messages from stdin, sends each one to The Deployer's hosted endpoint over HTTPS with your key, and writes the answers to stdout. The tools run on The Deployer, so this package doesn't change when they do.

Every request gets an answer. When The Deployer refuses one or can't be reached, the answer is an error that says why, such as a revoked key or a timeout. The bridge never follows redirects, and it never puts your key anywhere but the Authorization header.

VariableMeaning
THEDEPLOYER_API_KEYYour personal API key. Without it, only check_repo works
THEDEPLOYER_MCP_URLThe endpoint, if not https://app.thedploy.com/api/v1/mcp. It must use https://, except on this computer (127.0.0.1, ::1 or localhost)
THEDEPLOYER_TIMEOUT_MSHow long to wait for one answer, in milliseconds, from 1000 to 600000 (default 200000)
sh
npm test

License

MIT

来源:README.md,提交 cb94976

工具

23

check_repo

Check a repository

Checks whether a public GitHub, GitLab or Bitbucket repository will deploy: the services it found, what's missing (each with its fix), the environment variables it needs, and what it would cost a month on DigitalOcean, AWS, Google Cloud and Azure. Reads the code and changes nothing. Works without signing in. A check can take up to a minute; one still running returns a check_id that fetches its result.

输入参数repocheck_id

plan_deploy

Plan a deploy

Plans deploying a repository with the user's account on The Deployer: the repository check, plus the user's connected cloud and git accounts, any project they already have for it, and the steps left, with links. Changes nothing.

输入参数repo必填cloud

status

Project status

Lists the user's projects on The Deployer, or one project: whether each is live, its live addresses, and its latest deployment and where that is. Changes nothing.

输入参数projectworkspace

logs

Deployment logs

The log of a project's latest deployment, or of a given deployment, newest lines last, with secrets removed. errors_only keeps only errors and warnings. The lines are the build's and the app's own output. Changes nothing.

输入参数linesprojectworkspaceerrors_onlydeployment_id

redeploy

Redeploy a live project

Puts the latest code on a live project's branch online: pulls it and restarts the app, like Pull & Restart in The Deployer. Changes a live app. Only for a project that is already live. Takes a few minutes.

输入参数projectworkspace

request_done_for_you

Request done-for-you help

Asks The Deployer's team to do it for the user: launch (put an app online in the user's own cloud account), launch_secure (the same, with exposed keys and other security problems fixed first) or move (move an app from another host, such as Heroku, into it). Tells the team, and returns the price, the delivery promise and the link where the user finishes the order and pays. Never charges anything.

输入参数noterepooffer必填

guide

How to use The Deployer

The Deployer's playbooks, by topic: what The Deployer does, the order of an end-to-end deploy, what code needs to deploy and how to fix it, how failed deployments are fixed, and domains, scaling, env, databases, access, environments, servers, adoption and teams. Works without signing in. Changes nothing.

输入参数topic

account

Account and connections

Who the connection acts for, what it may do (Operate or Limited), the connected cloud accounts and code hosts with their ids, the workspaces the person is a member of, and how many projects they can see. Changes nothing.

输入参数workspace

project

Project in depth, with the next step

One project in depth: phase, services found in the repository, env names the code reads and which are still missing (never values), hosting plans with monthly costs, pending code-review changes, to-dos only the person can do, recent deployments, live URLs, and next_steps: what is left to do, in order. Changes nothing.

输入参数projectworkspace

deployment

Deployment progress and failure guidance

Where a deployment is (every step), what it waits on (a health-check proposal or a manual step), and for a failed one: the kind of failure, what to do about it, and the last error lines. Defaults to the project's latest deployment. Changes nothing.

输入参数projectworkspacewait_secondsdeployment_id

diagnose

Check a live server

Read-only checks on a live project: url (requests the project's live addresses from The Deployer's side), containers (what runs and its state), app_logs (the app's own recent output, secrets removed), resources (load, memory, disk) or web_server (the HTTPS proxy's log). Fixed commands only; changes nothing. All but url need a server (not managed services). Needs Deploy access on the project.

输入参数nodechecklinesproject必填containerworkspace

create_project

Create a project

Creates a project from a repository the person's connected code host can read, on one of their connected cloud accounts, and starts the repository scan. Nothing is deployed and nothing costs money yet. With one connected cloud, that one is used; otherwise cloud (a provider) or cloud_connection_id picks it. Needs Operate access.

输入参数namerepo必填cloudbranchworkspacegit_connection_idcloud_connection_id

set_env

Set env variables

Sets (or deletes) env variable values for the service a project deploys. Values are stored encrypted and are never returned. Other values are kept. On a live project, the services whose env changed are redeployed; otherwise the values apply on the next deployment. Multi-line values are stored as credential files. Needs Operate access.

输入参数deletevaluesproject必填serviceworkspace

launch

Launch a project

The first (or a full) deployment of a project into the person's cloud, once a hosting plan is selected. Without confirm=true it changes nothing and returns the plan and its monthly cost. With confirm=true it creates resources the person's cloud provider bills them for; it takes 5 to 20 minutes. Needs Operate access.

输入参数confirmproject必填workspaceconfirm_cost

api_catalog

List the operations

Every operation of The Deployer's app available through this server, grouped: account, connections, projects, env, build, code, architecture, deploy, domains, scaling, access, services, environments, blueprints, servers, adopt, team. Each is marked as a read or a change. Works without signing in.

输入参数group

api_schema

Describe an operation

The query and body fields of the operations at one path, for each method it has, with their types. Changes nothing.

输入参数path必填

api_read

Read an operation's answer

Runs one read (GET) operation of The Deployer's app as the person: domains, scaling, schedules, databases and other cloud services, app access, environments, blueprints, servers and more. Changes nothing. Secrets are never returned. Documented at https://portal.thedploy.com/docs.

输入参数path必填queryworkspace

api

Change something through an operation

Runs one change (POST, PUT, PATCH or DELETE) of The Deployer's app as the person, with the same permission checks the app applies: domains, scaling, start/stop and schedules, databases and other cloud services, app access, build inputs, code review, hosting plans, retries, environments, blueprints, servers, adoption and more. Needs Operate access. Some changes cost money or change a live app. Secrets are never returned. Documented at https://portal.thedploy.com/docs.

输入参数bodypath必填querymethod必填workspace

fixes

Code problems to fix

Fix requests: problems in the person's code that stop a deploy, found by The Deployer (a failed deployment, or the repository check) and assigned to the person's coding agent. Lists the open ones, in every project or one. Changes nothing.

输入参数projectworkspace

fix

One code problem in full

One fix request: the goal and rules (The Deployer's brief), and the evidence, which is what the build or app printed, fenced and marked as data from the repository and logs. Changes nothing.

输入参数id必填workspace

claim_fix

Take a code problem

Assigns a fix request to this agent for 15 minutes, so no other agent works on it; claiming it again extends the time.

输入参数id必填workspace

report_fix

Report the fix you pushed

Reports a pushed fix: the branch and the commit sha. The Deployer reads the commit from the git host, checks the change (no CI, agent settings or .env files; no secrets), then deploys it or opens a pull request for the person to ship, depending on the project's settings.

输入参数id必填sha必填notebranch必填workspace

fix_status

Follow a fix

Where a fix request is: checked, deploying, live, or open again with a new error. wait_seconds waits up to 120 seconds for it to change. Changes nothing.

输入参数id必填workspacewait_seconds

版本历史

2
  1. v0.3.0最新Oct 31, 2026
  2. v0.1.1Sep 16, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分