Basicdeploy Mcp

io.github.AkaciaNL由 GitHub 帳號 AkaciaNL 發布v1.0.7更新於 Oct 24, 2026

The runtime your agent deploys to — DB, storage, and a public URL in one MCP call.

已驗證STDIO僅桌面資料庫雲端與基礎設施開發者工具

概覽

AI 產生的概覽

讓 AI 程式代理建立與管理 BasicDeploy 容器，每個容器自帶 PostgreSQL 資料庫、S3 儲存、Kafka 與公開 HTTPS 網址。

可以做什麼
  • 列出、檢視、建立、喚醒、休眠、共用與永久刪除容器
  • 部署本機 tar 或 zip 壓縮檔，自動辨識執行環境並在 8080 埠啟動應用程式
  • 在容器內執行 shell 指令並取得最近的日誌
  • 管理 Kafka 主題：檢視連線資訊、建立、清空與刪除主題
  • 查詢目前驗證的帳號、方案額度與可選記憶體規格
適用情境
適合希望代理在對話中直接架起附帶資料庫、物件儲存與公開網址的託管應用程式，或維運、排查既有 BasicDeploy 容器與 Kafka 主題的情境。
執行需求
透過 npx 在本機執行，需要 Node.js 18 或更新版本。需要 BasicDeploy 帳號，並在 BASICDEPLOY_API_KEY 提供 API 金鑰；BASICDEPLOY_URL 為選用，可覆寫 API 基礎網址（預設指向 BasicDeploy 網站）。需要能連線至 BasicDeploy API 的網路。
安裝前請注意
API 金鑰是授權所有工具呼叫的機密，包含破壞性操作。delete_container 與 delete_topic 為永久操作，會銷毀資料、檔案與訊息；purge_topic 會刪除訊息；exec_command 可在容器內執行任意 shell 指令。較大記憶體規格與常開模式可能需要付費方案或附加項目，共用容器會寄送登入連結郵件給其他使用者。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Basicdeploy Mcp，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

[BasicDeploy]

BasicDeploy MCP Server

The persistent runtime your agent deploys to: a database, object storage, a Kafka broker, and a public URL, one MCP call.

An MCP (Model Context Protocol) server that lets AI coding agents (Claude Code, Cursor, and any MCP client) create and manage BasicDeploy containers directly. Every container comes with a PostgreSQL database, S3‑compatible object storage, a Kafka broker, environment variables, and a public HTTPS URL, all provisioned automatically. Your agent can create containers, deploy apps (Node, Python, Go, or Docker, auto‑detected), run commands, read logs, manage Kafka topics, check who it is authenticated as, set always‑on, and share or delete containers.

Quick start

Requires Node.js ≥ 18. No install needed. npx fetches it on demand.

Get an API key at https://basicdeploy.com/api-keys (it looks like bd_…, shown once), then add this to your MCP client:

json
{  "mcpServers": {    "basicdeploy": {      "command": "npx",      "args": ["-y", "basicdeploy-mcp@latest"],      "env": {        "BASICDEPLOY_API_KEY": "bd_your_api_key",        "BASICDEPLOY_URL": "https://basicdeploy.com"      }    }  }}

Claude Code:

bash
claude mcp add basicdeploy \  --env BASICDEPLOY_API_KEY=bd_your_api_key \  --env BASICDEPLOY_URL=https://basicdeploy.com \  -- npx -y basicdeploy-mcp@latest

Claude Code plugin (this repo doubles as a plugin marketplace):

bash
/plugin marketplace add AkaciaNL/basicdeploy-mcp/plugin install basicdeploy-mcp@basicdeploy

Then set BASICDEPLOY_API_KEY in your environment (the plugin reads it via ${BASICDEPLOY_API_KEY}).

OpenAI Codex CLI:

bash
codex mcp add basicdeploy \  --env BASICDEPLOY_API_KEY=bd_your_api_key \  --env BASICDEPLOY_URL=https://basicdeploy.com \  -- npx -y basicdeploy-mcp@latest

or add it directly to ~/.codex/config.toml:

toml
[mcp_servers.basicdeploy]command = "npx"args = ["-y", "basicdeploy-mcp@latest"]env = { BASICDEPLOY_API_KEY = "bd_your_api_key", BASICDEPLOY_URL = "https://basicdeploy.com" }

Environment variables

VariableRequiredDescription
BASICDEPLOY_API_KEYYesYour API key (bd_…). Required to call any tool (the server still starts and lists its tools without it, so clients can introspect it).
BASICDEPLOY_URLNoAPI base URL. Defaults to https://basicdeploy.com.

Tools

ToolArgumentsDescription
list_containers(none)List your containers: subdomain, status, URL, id, createdAt.
create_containermemoryMb? (256/512/1024/2048), alwaysOn?Create a container. Database + S3 bucket provisioned automatically. Larger sizes need Pro/Scale; always‑on on Free uses a paid add‑on slot.
get_containercontainerIdFull details: URL, status, ports, DB name/user, S3 bucket, volume path.
deploy_apptarballPath, containerId?Deploy a .tar/.tar.gz/.tgz/.zip from disk. Unpacks to /workspace, auto‑detects the runtime, and starts the app on :8080. Omit containerId to create a new container; pass one to deploy into an existing container.
exec_commandcontainerId, commandRun a shell command inside the container; returns output + exit code.
get_logscontainerId, tail? (default 200)Fetch recent container logs.
set_always_oncontainerId, enabledTurn a container's 24/7 always‑on flag on/off.
wake_containercontainerIdWake a slept container so it serves traffic again.
sleep_containercontainerIdSleep a running container to free memory (wakes on next request).
get_account(none)Your plan, container limit (plan + add‑ons), selectable memory sizes, storage limit, and add‑ons.
share_containercontainerId, email, expiresInHours?Share a container with another user by email (they get a sign‑in link). Omit expiresInHours for an unlimited share.
delete_containercontainerIdPermanent: destroys the container, its database, and all files.
whoami(none)The account this connection is authenticated as (email + id).
get_kafka(none)Kafka connection details (SASL/SCRAM): internal + external bootstrap, username/password, consumer‑group prefix, topics, usage and limits. Provisions on first call.
create_topiclabel?Create a Kafka topic (auto‑namespaced under your prefix; optional readable label). Fails if the topic/storage budget is exceeded.
purge_topicnameEmpty a topic you own (deletes its messages, keeps the topic). Restart processing after a mistake.
delete_topicnamePermanent: delete a topic you own and all its messages.

Runtime

Deployed apps must listen on 0.0.0.0:8080, the port the public URL serves. DATABASE_URL, S3_ENDPOINT / S3_ACCESS_KEY / S3_SECRET_KEY / S3_BUCKET, and KAFKA_BOOTSTRAP / KAFKA_USERNAME / KAFKA_PASSWORD / KAFKA_GROUP_PREFIX are preset in the container environment. Startup output goes to /workspace/deploy.log.

Example prompts

  • "Create a 1GB always‑on container and deploy ./dist/app.tar.gz to it, give me the URL."
  • "Show the last 100 log lines of my blue-fox container."
  • "What plan am I on and how many containers can I run?"
  • "Share my container with [email protected] for 24 hours."

License

MIT. BasicDeploy is a product of Akacia (KVK 99629569, Netherlands).

來源：README.md，提交 c6654bd

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v1.0.7最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分