VibeKit

vibekit-mcp

适用于 VibeKit 的 MCP 服务，可从任意 MCP 客户端部署应用、管理托管服务并与 AI Agent 聊天。

此软件包用于访问 VibeKit 云/API。它不会将本地 Claude Code 实例连接到 Telegram。若要远程控制本地计算机，请使用 vibekit-agent。

远程使用（无需安装）

VibeKit 也以托管远程服务的形式运行，因此接受远程 MCP URL 的客户端（claude.ai 网页连接器、ChatGPT 等）无需安装：

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

将此 URL 粘贴到客户端的“自定义连接器”/“远程 MCP 服务”字段中。支持设置请求头的客户端也可以改为发送 Authorization: Bearer vk_your_api_key_here，并使用裸地址 https://mcp.vibekit.bot/mcp。请参阅下文的获取 API 密钥。

更倾向于本地 stdio 安装（例如 Claude Desktop）？请按以下步骤操作。

获取 API 密钥

密钥以 vk_ 开头。获取方式有两种：

• **即时获取，无需注册：**发送一个请求即可获取密钥。

  curl -X POST https://vibekit.bot/api/v1/auth/register
  # Response: {"apiKey": "vk_...", "plan": "free", "credits": 0}
  

  保存返回的密钥并重复使用。每次调用 /auth/register 都会创建一个全新账户，因此只需调用一次，不要每次请求都调用。
• **从账户获取：**如果你已经在使用 VibeKit，可以在网页控制面板或 iOS 应用设置中复制或重新生成密钥。

安装

npm install -g vibekit-mcp

设置

1. 获取 VibeKit API 密钥（请参阅上文的获取 API 密钥）。

2. 将其添加到 MCP 客户端配置中（例如 Claude Desktop）（macOS 上的配置路径为 ~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "vibekit": {
      "command": "vibekit-mcp",
      "env": {
        "VIBEKIT_API_KEY": "vk_your_api_key_here"
      }
    }
  }
}

3. 重启 MCP 客户端

可用工具

托管服务

工具	描述
vibekit_list_apps	列出所有托管的应用
vibekit_get_app	获取特定应用的详细信息
vibekit_list_templates	列出 vibekit_create_app 的起始模板
vibekit_create_app	根据模板创建新应用
vibekit_deploy	将 GitHub 仓库部署到托管服务
vibekit_redeploy	使用最新代码重新部署应用
vibekit_list_deploys	列出应用最近的部署及其状态和提交记录
vibekit_rollback_deploy	将应用回滚到之前的部署版本
vibekit_app_logs	获取应用日志
vibekit_restart_app	重启应用
vibekit_stop_app	停止应用
vibekit_start_app	启动已停止的应用
vibekit_app_env	获取应用环境变量
vibekit_set_env	设置应用环境变量
vibekit_delete_app	永久删除应用

Agent

工具	描述
vibekit_chat	与应用的 AI Agent 聊天
vibekit_agent_status	获取 Agent 状态
vibekit_agent_history	获取与 Agent 的聊天记录

数据库

工具	描述
vibekit_enable_database	为应用启用 Postgres 数据库
vibekit_database_status	获取数据库状态和连接信息
vibekit_db_schema	获取数据库架构（每张表及其列）
vibekit_db_query	执行只读 SQL 查询（仅限 SELECT，最多 200 行）
vibekit_db_table	使用分页和排序浏览单张表的行

QA

工具	描述
vibekit_run_qa	运行自动化 QA 测试
vibekit_qa_status	获取 QA 测试结果

任务

工具	描述
vibekit_submit_task	提交编码任务
vibekit_get_task	获取任务状态/结果
vibekit_list_tasks	列出最近的任务
vibekit_wait_for_task	等待任务完成
vibekit_cancel_task	取消正在运行的任务
vibekit_create_schedule	创建定期计划任务
vibekit_list_schedules	列出计划任务
vibekit_delete_schedule	删除计划任务

账户

工具	描述
vibekit_account	获取账户信息（套餐、额度、用量）
vibekit_list_skills	列出实现技能
vibekit_get_skill	获取特定技能内容

示例用法

配置完成后，你可以使用如下提示词：

• “将我的 GitHub 仓库部署到 VibeKit 并创建一个新应用”
• “与我应用的 AI Agent 聊聊如何添加联系表单”
• “显示我应用的日志，如果有错误就重启应用”
• “为我的应用启用数据库，然后显示其架构并查询 users 表”
• “列出我应用最近的部署，并回滚到上一个可正常运行的版本”
• “对我已部署的应用运行 QA 测试”
• “查看我的 VibeKit 账户余额并列出我的应用”
• “创建每周计划，以提升我应用的性能”

环境变量

变量	描述	默认值
VIBEKIT_API_KEY	你的 VibeKit API 密钥（必填）	无
VIBEKIT_API_URL	API 基础 URL	https://vibekit.bot/api/v1

相关软件包

• vibekit-cli：用于 VibeKit 云端工作流的终端客户端
• vibekit-agent：用于在你自己的机器上运行本地 Claude Code 的 Telegram 桥接工具

链接

• VibeKit 网站
• API 文档
• 控制面板（查看或重新生成你的 API 密钥）
• GitHub

隐私政策

VibeKit 的隐私政策：https://vibekit.bot/privacy

具体而言，此 MCP 服务如何处理你的数据：

• 每次工具调用都会通过 HTTPS 转发到 VibeKit API（https://vibekit.bot/api/v1），并使用你配置的 API 密钥进行身份验证。VibeKit 会根据上述隐私政策处理工具输入和输出，以运行你的应用和 Agent。
• MCP 服务本身不保留任何状态：不会向磁盘写入任何内容，此软件包不会收集分析数据或遥测数据，你的 API 密钥从配置（VIBEKIT_API_KEY／扩展的密钥字段）中读取，并且只会发送到 vibekit.bot。
• 数据保留、与第三方共享及删除事宜均由上述政策规定。如有疑问，请联系：[email protected]。