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 分