VibeKit

io.github.VibeKit-Bot由 GitHub 账号 VibeKit-Bot 发布v0.8.0更新于 Oct 24, 2026

Build, deploy, and operate hosted web apps on VibeKit (vibekit.bot) from any MCP client.

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

概览

AI 生成的概览

VibeKit 的托管 MCP 服务器,可在 vibekit.bot 上创建、部署和运维 Web 应用,并提供 AI 编码代理、Postgres 数据库与 QA 运行。

可以做什么
  • 列出、查看、创建和删除托管应用,从 GitHub 仓库或起始模板部署与重新部署
  • 启动、停止、重启应用,读取日志,列出部署记录并回滚到旧版本
  • 读取和设置应用的环境变量
  • 与应用内置的 AI 编码代理对话、查看进度与历史,并提交、查询、等待或取消编码任务
  • 开通 Postgres 数据库,查看表结构、执行只读查询或分页浏览表数据
  • 运行无头浏览器自动化 QA 并查看结果;管理按 cron 周期执行的定时任务
适用场景
适合希望在不离开对话的情况下,让助手在 VibeKit 托管上构建、上线和维护 Web 应用的场景,例如部署仓库、排查日志、回滚有问题的部署、查询应用数据库,或发起 AI 编码任务与 QA 运行。
运行要求
需要 VibeKit 账户和 API 密钥(以 vk_ 开头):本地安装时通过环境变量 VIBEKIT_API_KEY 提供,远程端点则用 api_key 查询参数或 Authorization Bearer 头。需要访问 vibekit.bot 的网络。本地方式为 npm 包,需要 Node.js。
安装前请注意
该密钥可完全控制账户:可创建、重新部署、重启、停止乃至永久删除应用,并可读取和修改环境变量。删除应用不可恢复,会一并移除数据库、环境变量和子域名。AI 代理和提交的任务会写入代码、提交到 GitHub 并默认部署。开通数据库可能需要付费附加项,并会消耗额度。所有工具调用都会转发到 VibeKit API。

安装

在 SourceWeft 中

  1. 打开 控制台中的 VibeKit,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

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

交给智能体安装

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

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

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

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "vibekit": {
      "type": "http",
      "url": "https://mcp.vibekit.bot/mcp"
    }
  }
}

README

vibekit-mcp

[smithery badge]

MCP server for VibeKit, deploy apps, manage hosting, and chat with AI agents from any MCP client.

This package is for VibeKit cloud/API access. It does not connect your local Claude Code instance to Telegram. For local-machine remote control, use vibekit-agent.

Use it remotely (no install)

VibeKit also runs as a hosted remote server, so clients that accept a remote MCP URL (claude.ai web connectors, ChatGPT, etc.) need no install:

https://mcp.vibekit.bot/mcp?api_key=vk_your_api_key_here

Paste that URL into your client's "custom connector" / "remote MCP server" field. Clients that let you set headers can instead send Authorization: Bearer vk_your_api_key_here and use the bare https://mcp.vibekit.bot/mcp. See Get an API key below.

Prefer a local stdio install (e.g. Claude Desktop)? Use the steps below.

Get an API key

Keys start with vk_. Two ways to get one:

  • Instant, no signup: one request returns a key.
    bash
    curl -X POST https://vibekit.bot/api/v1/auth/register# Response: {"apiKey": "vk_...", "plan": "free", "credits": 0}
    Save the returned key and reuse it. Each call to /auth/register creates a brand-new account, so call it once, not per request.
  • From your account: if you already use VibeKit, copy or regenerate your key in the web dashboard or the iOS app settings.

Installation

bash
npm install -g vibekit-mcp

Setup

  1. Get a VibeKit API key (see Get an API key above).

  2. Add to your MCP client config (e.g. Claude Desktop) (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

json
{  "mcpServers": {    "vibekit": {      "command": "vibekit-mcp",      "env": {        "VIBEKIT_API_KEY": "vk_your_api_key_here"      }    }  }}
  1. Restart your MCP client

Available Tools

Hosting

ToolDescription
vibekit_list_appsList all hosted apps
vibekit_get_appGet details about a specific app
vibekit_list_templatesList starter templates for vibekit_create_app
vibekit_create_appCreate new app from a template
vibekit_deployDeploy GitHub repo to hosting
vibekit_redeployRedeploy app with latest code
vibekit_list_deploysList an app's recent deploys with status and commit
vibekit_rollback_deployRoll an app back to a previous deploy
vibekit_app_logsGet application logs
vibekit_restart_appRestart an app
vibekit_stop_appStop an app
vibekit_start_appStart a stopped app
vibekit_app_envGet app environment variables
vibekit_set_envSet app environment variables
vibekit_delete_appDelete an app permanently

Agent

ToolDescription
vibekit_chatChat with an app's AI agent
vibekit_agent_statusGet agent status
vibekit_agent_historyGet chat history with agent

Database

ToolDescription
vibekit_enable_databaseEnable a Postgres database for an app
vibekit_database_statusGet database status and connection info
vibekit_db_schemaGet the database schema (every table and its columns)
vibekit_db_queryRun a read-only SQL query (SELECT only, up to 200 rows)
vibekit_db_tableBrowse one table's rows with pagination and sorting

QA

ToolDescription
vibekit_run_qaRun automated QA tests
vibekit_qa_statusGet QA test results

Tasks

ToolDescription
vibekit_submit_taskSubmit a coding task
vibekit_get_taskGet task status/result
vibekit_list_tasksList recent tasks
vibekit_wait_for_taskWait for task completion
vibekit_cancel_taskCancel a running task
vibekit_create_scheduleCreate recurring scheduled task
vibekit_list_schedulesList scheduled tasks
vibekit_delete_scheduleDelete scheduled task

Account

ToolDescription
vibekit_accountGet account info (plan, credits, usage)
vibekit_list_skillsList implementation skills
vibekit_get_skillFetch specific skill content

Example Usage

Once configured, you can use prompts like:

  • "Deploy my GitHub repo to VibeKit and create a new app"
  • "Chat with the AI agent for my app about adding a contact form"
  • "Show me the logs for my app and restart it if there are errors"
  • "Enable a database for my app, then show me its schema and query the users table"
  • "List my app's recent deploys and roll back to the last working one"
  • "Run QA tests on my deployed app"
  • "Check my VibeKit account balance and list my apps"
  • "Create a weekly schedule to improve my app's performance"

Environment Variables

VariableDescriptionDefault
VIBEKIT_API_KEYYour VibeKit API key (required)none
VIBEKIT_API_URLAPI base URLhttps://vibekit.bot/api/v1

Related Packages

  • vibekit-cli: terminal client for VibeKit cloud workflows
  • vibekit-agent: Telegram bridge for local Claude Code on your own machine

Links

Privacy Policy

VibeKit's privacy policy: https://vibekit.bot/privacy

What this MCP server does with your data, concretely:

  • Every tool call is forwarded to the VibeKit API (https://vibekit.bot/api/v1) over HTTPS, authenticated with the API key you configure. Tool inputs and outputs are processed by VibeKit to run your apps and agents, under the privacy policy above.
  • The server itself keeps no state: nothing is written to disk, no analytics or telemetry are collected by this package, and your API key is read from configuration (VIBEKIT_API_KEY / the extension's key field) and sent only to vibekit.bot.
  • Data retention, third-party sharing, and deletion are governed by the policy above. Questions: [email protected].

来源:README.md,提交 54e8187

工具

36

vibekit_list_apps

VibeKit List Apps

List all hosted apps in your VibeKit account, each with its id, subdomain, status, and live URL. Start here to get an appId for the other app tools.

无需输入参数。

vibekit_get_app

VibeKit Get App

Get full details for one hosted app — status, subdomain/URL, repo, runtime, and database/domain config. Use the appId from vibekit_list_apps.

输入参数appId必填

vibekit_create_app

VibeKit Create App

Create a new hosted app from a starter template and deploy it live at <subdomain>.vibekit.bot. Call vibekit_list_templates first to pick a valid template. To deploy existing code from a GitHub repo instead, use vibekit_deploy.

输入参数template必填subdomain必填

vibekit_list_templates

VibeKit List Templates

List the starter templates available to vibekit_create_app (e.g. landing, dashboard, blog, saas, crud-api). Call this before vibekit_create_app to choose a valid template.

无需输入参数。

vibekit_deploy

VibeKit Deploy

Deploy a GitHub repo to VibeKit hosting, live at <subdomain>.vibekit.bot (Fargate container behind nginx, SSL automatic). Use when the code already lives in a GitHub repo; for a starter template instead use vibekit_create_app.

输入参数repo必填subdomain必填

vibekit_redeploy

VibeKit Redeploy

Redeploy an existing app to pull and ship the latest code. Use after pushing changes to the app's GitHub repo.

输入参数appId必填

vibekit_app_logs

VibeKit App Logs

Fetch recent container/application logs for an app. Use this to debug crashes, errors, or a deploy that isn't serving.

输入参数appId必填lines

vibekit_restart_app

VibeKit Restart App

Restart a hosted app's container. Use when an app is wedged, or to apply changed environment variables.

输入参数appId必填

vibekit_stop_app

VibeKit Stop App

Stop a hosted app's container. The app stays in your account and can be brought back with vibekit_start_app. Use to take an app offline without deleting it.

输入参数appId必填

vibekit_start_app

VibeKit Start App

Start a stopped hosted app's container. Use to bring an app stopped via vibekit_stop_app back online.

输入参数appId必填

vibekit_app_env

VibeKit Get Env Vars

Get the environment variables configured for an app (names and values). Read-only — use vibekit_set_env to change them.

输入参数appId必填

vibekit_set_env

VibeKit Set Env Vars

Set or update environment variables for an app (merges with existing). The app must be restarted or redeployed for changes to take effect.

输入参数vars必填appId必填

vibekit_delete_app

VibeKit Delete App

Permanently delete a hosted app — stops the container and removes its workspace, database, env vars, and subdomain. Irreversible (the GitHub repo is NOT touched). Confirm with the user before calling.

输入参数appId必填

vibekit_chat

VibeKit Chat with Agent

Send a message to an app's built-in AI coding agent, which reads, writes, and modifies the app's code and redeploys it. Use for 'build/make a change to my app' requests. If the agent finishes quickly you get its reply directly. Otherwise you get status:'working' — do NOT resend; instead give the user LIVE progress: poll vibekit_agent_status every few seconds and relay the current step from activity.status ('editing the homepage…', 'deploying…') until activity.done, then read vibekit_agent_history for the final reply.

输入参数appId必填message必填

vibekit_agent_status

VibeKit Agent Status

Check whether an app's AI agent is idle or working, and get its LIVE progress. Returns activity.status = the current human-readable build step (e.g. 'editing index.html', 'deploying'), activity.steps = the steps so far, and activity.done = whether the turn finished. Poll this every few seconds while a build is running and relay activity.status to the user so they see progress. Once activity.done is true the response also includes liveCheck = a server-side fetch of the deployed page ({ url, ok, httpStatus, title }); use it to confirm the app is live and renders — do NOT curl/fetch the URL yourself, your sandbox may block it.

输入参数appId必填

vibekit_agent_history

VibeKit Agent History

Get the recent chat history between the user and an app's AI agent.

输入参数appId必填limit

vibekit_enable_database

VibeKit Enable Database

Provision a Postgres database for an app (idempotent — safe if already enabled). Required before the vibekit_db_* tools work. Note: free-tier apps need the $3/mo Database add-on.

输入参数appId必填

vibekit_database_status

VibeKit Database Status

Get an app's database status and connection info (whether it's provisioned, frozen, etc.).

输入参数appId必填

vibekit_db_schema

VibeKit Database Schema

Get an app's database schema — every table and its columns. Always call this before writing a query with vibekit_db_query.

输入参数appId必填

vibekit_db_query

VibeKit Run SQL Query

Run a read-only SQL query against an app's Postgres database and return up to 200 result rows. SELECT only — writes and DDL (INSERT/UPDATE/DELETE/ALTER/DROP/…) are rejected server-side; use vibekit_chat or vibekit_submit_task to have the agent make data or schema changes. Call vibekit_db_schema first to learn the tables. SQL string, max 5000 chars.

输入参数sql必填appId必填

vibekit_db_table

VibeKit Browse Table

Browse rows of one table with pagination and optional sorting — a quick read-only alternative to hand-writing a SELECT.

输入参数appId必填limittable必填offset

vibekit_list_deploys

VibeKit List Deploys

List an app's recent deploys, newest first, with status and commit info. Find a deployId here to pass to vibekit_rollback_deploy.

输入参数appId必填limit

vibekit_rollback_deploy

VibeKit Rollback Deploy

Roll an app back to a previous deploy (get the deployId from vibekit_list_deploys). The container restarts on the rolled-back build; reversible by rolling forward again.

输入参数appId必填deployId必填

vibekit_run_qa

VibeKit Run QA

Kick off an automated QA run (headless-browser checks) against a hosted app. Poll vibekit_qa_status for results.

输入参数appId必填

vibekit_qa_status

VibeKit QA Status

Get the latest automated QA results and status for an app.

输入参数appId必填

vibekit_submit_task

VibeKit Submit Task

Submit an autonomous coding task. The AI writes the code, commits to GitHub, and (by default) deploys to <subdomain>.vibekit.bot. Returns a taskId — poll vibekit_get_task or block with vibekit_wait_for_task. Use for 'build X' or 'change X' work against a repo.

输入参数repotask必填branchdeploycallbackUrl

vibekit_get_task

VibeKit Get Task

Get the status and result of a task submitted via vibekit_submit_task.

输入参数taskId必填

vibekit_list_tasks

VibeKit List Tasks

List recent coding tasks, optionally filtered by status.

输入参数limitstatus

vibekit_wait_for_task

VibeKit Wait for Task

Block until a submitted task finishes (or the timeout), polling every 5 seconds, then return its result. Use right after vibekit_submit_task when you want the final result inline.

输入参数taskId必填timeoutSeconds

vibekit_cancel_task

VibeKit Cancel Task

Cancel a running task by taskId. No-op if it has already finished.

输入参数taskId必填

vibekit_create_schedule

VibeKit Create Schedule

Create a recurring coding task that the AI runs automatically on a cron schedule (e.g. a weekly SEO pass). Use for 'every Monday, do X to my repo' requests.

输入参数cron必填namerepo必填task必填

vibekit_list_schedules

VibeKit List Schedules

List all of the account's scheduled recurring tasks.

无需输入参数。

vibekit_delete_schedule

VibeKit Delete Schedule

Delete a scheduled recurring task by scheduleId. Confirm with the user first.

输入参数scheduleId必填

vibekit_account

VibeKit Account Info

Get VibeKit account info: plan, credit balance, and usage.

无需输入参数。

vibekit_list_skills

VibeKit List Skills

List available implementation skills (IDs, names, descriptions, tags) from the VibeKit skills registry. Discover skills here before fetching one with vibekit_get_skill.

输入参数tag

vibekit_get_skill

VibeKit Get Skill

Fetch the full content of a specific skill — implementation patterns, code examples, and best practices for a domain. Fetch on-demand when you need guidance on a specific topic.

输入参数id必填

版本历史

1
  1. v0.8.0最新Sep 16, 2026

评分

已满足适用检查项的 100%

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

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