内容
# VibeKit-MCP 服务器
[](https://smithery.ai/servers/vibekit/vibekit-mcp)
VibeKit 的 MCP 服务器，用于部署应用、管理托管和与 AI 代理聊天。
本软件包适用于 **VibeKit 云/API 访问**。它 **不** 连接您的本地 Claude Code 实例到 Telegram。如需本地机器远程控制，请使用 `vibekit-agent`。
## 远程使用（无需安装）
VibeKit 也作为托管的远程服务器运行，因此接受远程 MCP URL 的客户端（claude.ai 网页连接器、ChatGPT 等）无需 **安装**:
```
https://mcp.vibekit.bot/mcp?api_key=vk_您的_api_key_在此
```
将该 URL 粘贴到客户端的“自定义连接器”/“远程 MCP 服务器”字段中。允许设置标头的客户端可以改为发送 `Authorization: Bearer vk_您的_api_key_在此`，并使用裸 `https://mcp.vibekit.bot/mcp`。参见下面的[获取 API 密钥](#获取-api-密钥)。
更喜欢本地 stdio 安装（例如 Claude Desktop）？请按照以下步骤操作。
## 获取 API 密钥
密钥以 `vk_` 开头。有两种获取密钥的方法：
- **即时，无需注册：** 一个请求返回一个密钥。
```bash
curl -X POST https://vibekit.bot/api/v1/auth/register
# 响应：{"apiKey": "vk_...", "plan": "free", "credits": 0}
```
保存返回的密钥并重用它。每次调用 `/auth/register` 都会创建一个全新的帐户，因此请调用一次，而不是每次请求都调用。
- **从您的帐户：** 如果您已经使用 VibeKit，请在[网页仪表板](https://app.vibekit.bot)或 iOS 应用设置中复制或重新生成您的密钥。
## 安装
```bash
npm install -g vibekit-mcp
```
## 设置
1. 获取 VibeKit API 密钥（参见上面的[获取 API 密钥](#获取-api-密钥)）。
2. 将以下内容添加到您的 MCP 客户端配置（例如 Claude Desktop）（`~/Library/Application Support/Claude/claude_desktop_config.json` 在 macOS 上）：
```json
{
"mcpServers": {
"vibekit": {
"command": "vibekit-mcp",
"env": {
"VIBEKIT_API_KEY": "vk_您的_api_key_在此"
}
}
}
}
```
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` | 永久删除应用 |
### 代理
| 工具 | 描述 |
|------|-------------|
| `vibekit_chat` | 与应用的 AI 代理聊天 |
| `vibekit_agent_status` | 获取代理状态 |
| `vibekit_agent_history` | 获取与代理的聊天记录 |
### 数据库
| 工具 | 描述 |
|------|-------------|
| `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 代理聊天，关于添加联系人表单”
- “显示我的应用日志并重启它，如果有错误”
- “为我的应用启用数据库，然后显示其模式并查询用户表”
- “列出我的应用的最近部署并回滚到上一个正常运行的部署”
- “在我的部署的应用上运行 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 网站](https://vibekit.bot)
- [API 文档](https://vibekit.bot/SKILL.md)
- [仪表板](https://app.vibekit.bot)（查看或重新生成您的 API 密钥）
- [GitHub](https://github.com/VibeKit-Bot/vibekit-mcp)
