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 分