内容
<p align="center">
<img src="https://img.shields.io/badge/license-MIT-blue" alt="MIT">
<img src="https://img.shields.io/badge/node-%3E%3D18-brightgreen" alt="Node >=18">
<img src="https://img.shields.io/badge/MCP-1.0.0-purple" alt="MCP">
<img src="https://img.shields.io/badge/status-ativo-success" alt="Status">
</p>
<div align="center">
<h1>verboo-bridge</h1>
<p><strong>使用 Verboo 模型作为 Claude Code、Codex、OpenCode、Cursor 或任何 MCP 客户端的子代理</strong></p>
<p>将无限 Verboo Token 转换为分布式执行，以适应您首选的编排器</p>
</div>
---
## 架构
```mermaid
graph TB
subgraph "编排器"
CLAUDE[Claude Code]
CODEX[Codex]
OPENCODE[OpenCode]
CURSOR[Cursor]
end
subgraph "verboo-bridge"
MCP[MCP Server<br/>stdio]
CLI[CLI wrapper<br/>bin/vb]
AGENT[verboo_agent<br/>executor por chamada]
NATIVE[Verboo Code 原生<br/>OAuth]
HARNESS[OpenCode<br/>fallback]
end
subgraph "Verboo API"
DS[DeepSeek V4 Flash<br/>1M ctx]
GLM[GLM 5.2<br/>512K ctx]
MIMO[Mimo V2.5<br/>1M ctx]
OUTROS[Kimi / Minimax / Qwen]
end
CLAUDE -->|MCP tools| MCP
CODEX -->|MCP tools| MCP
CURSOR -->|MCP tools| MCP
Terminal -->|CLI 直接| CLI
MCP --> AGENT
AGENT -->|executor: native| NATIVE
AGENT -->|executor: opencode| HARNESS
NATIVE -->|OAuth| DS
HARNESS -->|provider verboo| DS
OPENCODE -->|provider verboo| DS
MCP -->|API key| DS
MCP -->|API key| GLM
MCP -->|API key| MIMO
MCP -->|API key| OUTROS
CLI -->|API key| DS
CLI -->|API key| OUTROS
```
---
## 可用模型
| 模型 | 上下文 | 层级 | SWE-bench Pro | Terminal-Bench | WebDev Arena | 理想用途 |
|--------|----------|------|:-:|:-:|:-:|-----------|
| **DeepSeek V4 Flash** | 1.048.576 | 专业 | 82-89% | 56.9 | - | 通用编码，**最佳性价比** |
| **Mimo V2.5** | 1.048.576 | 专业 | - | - | - | 重量级分析，63 tok/s |
| **GLM 4.7 Flash** | 200.704 | 专业 | - | - | - | 快速任务 |
| **Qwen 3.6 27B** | 262.144 | 专业 | - | - | - | 轻量级任务，27B 参数 |
| **GLM 5.2** | 524.288 | 超级 | 62.1% | 81.0 | #2 (1.593 Elo) | 复杂推理 |
| **Kimi K2.7** | 262.144 | 超级 | ~60% | - | - | 通用任务，视觉 |
| **Minimax M3** | 1.048.576 | 超级 | - | - | - | 编码，87 tok/s，视觉 |
---
## 快速安装
```bash
git clone https://github.com/nikolasdehor/verboo-bridge.git
cd verboo-bridge
npm install
```
要求：Node.js 18+ 和 `verboo_agent` 需要 `@verboo/code` 带有 OAuth 或 OpenCode 1.17.9+ 作为备用。
### 环境变量
```bash
export VERBOO_AGENT_ALLOWED_ROOTS="/path/to/your/projects"
# 默认可选；每次调用可以选择原生或 OpenCode
export VERBOO_AGENT_EXECUTOR="native"
export VERBOO_CODE_BIN="/path/to/verboo"
# 可选且敏感：启用编辑（无 shell）
export VERBOO_AGENT_WRITE_ENABLED="1"
```
在使用原生模式之前，请使用 `verboo auth login` 或 `verboo auth login --headless` 登录官方 CLI。OAuth 会话由用户目录的子进程读取；API 密钥不会传递给原生执行器。
`verboo_agent` 接受 `executor: "native"` 或 `executor: "opencode"` 在每次调用中。调用的选择优先于 `VERBOO_AGENT_EXECUTOR`。如果没有配置，则默认为 `native`。
如果 `verboo` 命令未指向官方 CLI，请使用 Node 和入口点：
```bash
export VERBOO_CODE_BIN="/path/to/node"
export VERBOO_CODE_ENTRYPOINT="/path/to/@verboo/code/dist/cli.mjs"
```
`VERBOO_API_KEY` 仍然可用于简单的提示工具（`verboo_code`、`verboo_review` 和模型工具）。请勿在存储库中保存密钥。
---
## 平台配置
### Claude Code
在 `~/.claude.json` 中添加：
```json
{
"mcpServers": {
"verboo-bridge": {
"command": "node",
"args": ["/path/to/verboo-bridge/index.mjs"],
"env": {
"VERBOO_AGENT_ALLOWED_ROOTS": "/path/to/your/projects",
"VERBOO_AGENT_EXECUTOR": "native",
"VERBOO_CODE_BIN": "/path/to/verboo"
}
}
}
}
```
Claude Code 可能仍需要批准 MCP 调用。此批准由编排器提供，与 OAuth 和 Verboo Code 内部权限分开。调用中的 `executor` 字段允许用户或编排器在不重启 MCP 的情况下选择原生或 OpenCode 备用方案。
### OpenCode
**选项 1 — MCP 服务器**:
```json
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"verboo-bridge": {
"type": "local",
"command": ["node", "/path/to/verboo-bridge/index.mjs"],
"environment": {
"VERBOO_API_KEY": "{env:VERBOO_API_KEY}",
"VERBOO_AGENT_ALLOWED_ROOTS": "/path/to/your/projects",
"VERBOO_OPENCODE_BIN": "/path/to/opencode"
},
"enabled": true
}
}
}
```
要启用有意识的编辑，请在 `environment` 块中添加 `"VERBOO_AGENT_WRITE_ENABLED": "1"`。否则，`verboo_agent` 仅接受 `read_only`。
**选项 2 — 直接提供者** （`verboo_agent` 使用 `executor: "opencode"` 时需要）：
```json
{
"provider": {
"verboo": {
"name": "Verboo",
"npm": "@ai-sdk/openai-compatible",
"options": {
"baseURL": "https://code.verboo.ai/router/v1",
"apiKey": "{env:VERBOO_API_KEY}"
},
"models": {
"deepseek-v4-flash": { "name": "DeepSeek V4 Flash", "limit": { "context": 1048576, "output": 65536 } },
"glm-5.2": { "name": "GLM 5.2", "limit": { "context": 524288, "output": 65536 } },
"mimo-v2.5": { "name": "Mimo V2.5", "limit": { "context": 1048576, "output": 65536 } },
"kimi-k2.7": { "name": "Kimi K2.7", "limit": { "context": 262144, "output": 65536 } },
"minimax-m3": { "name": "Minimax M3", "limit": { "context": 1048576, "output": 65536 } },
"glm-4.7-flash": { "name": "GLM 4.7 Flash", "limit": { "context": 200704, "output": 65536 } },
"qwen3.6-27b": { "name": "Qwen 3.6 27B", "limit": { "context": 262144, "output": 65536 } }
}
}
}
}
```
### Codex
在 `~/.codex/config.toml` 中添加：
```toml
[mcp_servers.verboo-bridge]
command = "node"
args = ["/path/to/verboo-bridge/index.mjs"]
[mcp_servers.verboo-bridge.env]
VERBOO_AGENT_ALLOWED_ROOTS = "/path/to/your/projects"
VERBOO_AGENT_EXECUTOR = "native"
VERBOO_CODE_BIN = "/path/to/verboo"
```
Codex 仍然控制 `verboo_agent` 的调用批准。原生执行器仅接收与请求模式兼容的工具：`read_only` 模式下的读取；`write` 模式下的读取和编辑；Bash、Web、钩子和内部 MCP 被阻止。
即使将 `VERBOO_AGENT_EXECUTOR` 设置为 `native` 作为默认值，一次调用也可以选择 `executor: "opencode"`。反之亦然。
请在更改配置后重启客户端。新的 MCP 不会在会话已经打开时进入。
### Cursor
在项目的 `.cursor/mcp.json` 中添加：
```json
{
"mcpServers": {
"verboo-bridge": {
"command": "node",
"args": ["/path/to/verboo-bridge/index.mjs"],
"env": {
"VERBOO_API_KEY": "${VERBOO_API_KEY}",
"VERBOO_AGENT_ALLOWED_ROOTS": "/path/to/your/projects",
"VERBOO_OPENCODE_BIN": "/path/to/opencode"
}
}
}
}
```
---
## 使用
### 通过 MCP（Claude/Codex/Cursor）
当 MCP 服务器注册后，编排器将可以访问这些工具：
| 工具 | 描述 |
|------|-----------|
| `verboo_agent` | 带有 `executor` 选择的 Repo-aware 子代理：Verboo Code 原生/OAuth 或 OpenCode (`read_only` 或 `write`) |
| `verboo_code` | 使用 DeepSeek V4 Flash 进行编码 |
| `verboo_review` | 代码审查 |
| `verboo_deepseek_v4_flash` | 特定模型 |
| `verboo_glm_5_2` | 特定模型 |
| `verboo_mimo_v2_5` | 特定模型 |
| `verboo_kimi_k2_7` | 特定模型 |
| `verboo_minimax_m3` | 特定模型 |
| `verboo_glm_4.7_flash` | 特定模型 |
| `verboo_qwen3.6_27b` | 特定模型 |
原生委托示例：
> _"使用 `verboo_agent`，带有 `executor: native`，在 `write` 模式下，cwd 在此存储库中，编辑此模块的测试。然后审查差异并在编排器上运行本地套件。"_
执行器选择：
- `native`：使用官方 CLI 和 OAuth 会话，保留 Verboo 的 Claude Code 风格的编排。
- `opencode`：在 OpenCode 提供的环境中执行相同的代理，需要配置 Verboo/API 密钥。
- 如果省略 `executor`，则使用 `VERBOO_AGENT_EXECUTOR`；如果未设置该变量，则默认为 `native`。
`read_only` 阻止编辑、shell、Web、嵌套代理和项目外部的访问。`write` 仅允许读取和编辑工具；shell、Web、嵌套代理和外部目录仍然被禁用。编排器仍然负责运行测试、审查差异、提交和部署。子进程仅接收最低限度的环境变量白名单；GitHub、AWS 等服务令牌不会被继承。`write` 模式在 `VERBOO_AGENT_WRITE_ENABLED` 为 `1` 之前会失败。
### 通过直接 CLI
```bash
# 简单提示
vb "解释 JavaScript 中的闭包"
# 使用特定模型和系统提示
vb -m glm-5.2 -s "简洁技术" "分析此算法的复杂度"
# 文件管道
cat main.py | vb -m mimo-v2.5 "审查此代码"
# 列出模型
vb --list
```
### 通过 Verboo Code 原生
```bash
verboo auth login
verboo -p --output-format stream-json "审查此项目"
```
### 通过 OpenCode（备用）
```bash
opencode run -m verboo/deepseek-v4-flash "重构此组件"
opencode run -m verboo/glm-5.2 "解决此复杂问题"
```
---
## 用于 Claude 和 Codex 的技能
要教 Claude 自动将批量任务委托给 Verboo，请复制技能文件：
```bash
cp -r skills/verboo-executor ~/.claude/skills/
cp -r skills/verboo-executor ~/.codex/skills/
```
技能教导模式：
1. Claude 接收任务
2. Claude 将任务分离为 **编排**（保留给 Claude）+ **批量**（委托给 Verboo）
3. Claude/Codex 选择 `executor: native` 或 `executor: opencode`
4. Claude/Codex 调用 `verboo_agent`，带有 `cwd`、模式和清晰的指令
5. Claude 集成并验证结果
---
## Verboo 计划
| 计划 | 价格 | Token | 连接数 | 模型 |
|-------|-------|--------|----------|---------|
| Junior | R$ 75/月 | 无限 | 2 | 基础模型 |
| **专业** | **R$ 174/月** | **无限** | **4** | **deepseek-v4-flash, mimo-v2.5 (1M ctx)** |
| Ultra | R$ 900/月 | 无限 | 2 | + GLM 5.2, 全部 |
> **推荐：** 专业版（R$ 174/月）— 4 个并发连接，1M 上下文，无限 Token。
> 唯一提供 4 个并发连接的计划（Ultra 仅限 2 个）。
---
## 真实示例
### 批量代码审查
```bash
# 一次性审查多个文件与 Verboo
for f in src/**/*.ts; do
cat "$f" | vb -m mimo-v2.5 -s "审查此 TypeScript 文件" > "reviews/$(basename $f).review.md"
done
```
### 辅助重构
```mermaid
sequenceDiagram
participant Vc as 你
participant C as Claude Code
participant VB as Verboo Bridge
Vc->>C: 重构此模块
C->>VB: verboo_code("提取付款逻辑")
VB-->>C: 重构代码
C->>VB: verboo_review(代码)
VB-->>C: 审查指出 2 个改进
C->>Vc: 最终修订结果
```
### 生成测试
> "Claude，请使用 `verboo_code` 为此模块生成单元测试。然后执行并告诉我它们是否通过。"
---
## MCP 服务器资源
服务器还公开 **资源** 和 **提示**:
| 类型 | URI | 描述 |
|------|-----|-----------|
| 资源 | `verboo://models` | 模型列表及其规格 |
| 资源 | `verboo://status` | 连接状态 |
| 提示 | `revisar-codigo` | 代码审查模板 |
| 提示 | `refatorar` | 重构模板 |
| 提示 | `explicar` | 解释模板 |
---
## 环境变量
| 变量 | 默认值 | 描述 |
|----------|---------|-----------|
| `VERBOO_API_KEY` | — | 直接提示工具和 `executor: opencode` 需要；不会传递给原生执行器 |
| `VERBOO_BASE_URL` | `https://code.verboo.ai/router/v1` | API 基本 URL |
| `VERBOO_LOG_LEVEL` | `info` | 日志级别：`debug`, `info`, `warn`, `error` |
| `VERBOO_AGENT_ALLOWED_ROOTS` | — | Repo-aware 根目录以 OS 路径分隔符分隔；无值时 `verboo_agent` 失败 |
| `VERBOO_AGENT_WRITE_ENABLED` | — | 定义 `1` 以启用 `write`；默认仅接受 `read_only` |
| `VERBOO_AGENT_MAX_CONCURRENCY` | `1` | 代理并发执行；整数 1 到 8，无效值使用 1 |
| `VERBOO_AGENT_EXECUTOR` | `native` | 管理员默认值；每次调用可以替换为 `|VERBOO_AGENT_EXECUTOR` | `native` | 管理员默认值；每次调用可以替换为 `native` 或 `opencode` |
| `VERBOO_CODE_BIN` | `verboo` | 官方 CLI 可执行文件；如果定义了 `VERBOO_CODE_ENTRYPOINT`，则可以是 Node |
| `VERBOO_CODE_ENTRYPOINT` | — | `@verboo/code/dist/cli.mjs` 的可选路径 |
| `VERBOO_OPENCODE_BIN` | `opencode` | OpenCode 1.17.9+ 的路径 |
| `VERBOO_ENV_FILE` | — | 可选文件，由 `bin/verboo-mcp` 读取以获取 `VERBOO_API_KEY` 而无需 `source` |
| `VERBOO_NODE_BIN` | `node` | `bin/verboo-mcp` 使用的 Node 二进制文件 |
---
## 开发
```bash
git clone https://github.com/nikolasdehor/verboo-bridge.git
cd verboo-bridge
npm install
node index.mjs
npm test
```
---
## 许可
MIT — 使用、修改、分享。
MCP 配置
以下是此 MCP Server 的配置信息，可直接复制到 Cursor 或其他 MCP 客户端中使用。
mcp.json
连接信息
猜你喜欢
暂无推荐服务器