opencode CLI 和类似的终端编码代理从配置中发现 MCP 服务器。添加 Scavio 后，代理可以在一个工具类中进行实时 Google SERP、Reddit、YouTube 和文档搜索。本教程可在 10 分钟内完成连接。
前置条件
- 安装了 opencode CLI
- Scavio API 密钥
- Node.js 20+（用于 mcp 远程桥）
操作指南
步骤 1: 打开 opencode MCP 配置
opencode 从 ~/.opencode/mcp.json 读取 MCP 服务器。
Bash
mkdir -p ~/.opencode && touch ~/.opencode/mcp.json步骤 2: 注册 Scavio MCP
使用 mcp-remote 将 HTTP SSE 桥接至 CLI 进程。
JSON
{
"mcpServers": {
"scavio": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.scavio.dev/mcp"],
"env": { "SCAVIO_API_KEY": "${SCAVIO_API_KEY}" }
}
}
}步骤 3: 导出 API 密钥
从 shell rc 加载，以便 CLI 继承它。
Bash
echo 'export SCAVIO_API_KEY=sk_live_...' >> ~/.zshrc && source ~/.zshrc步骤 4: 验证工具是否可见
启动 opencode 并列出工具。
Bash
opencode
> /tools
# Expect scavio_search, scavio_reddit, scavio_youtube步骤 5: 测试实时查询
询问需要新数据的内容。
Bash
> what does the latest r/opencodeCLI thread on web search say?Python 示例
Python
# opencode CLI is a CLI-first tool; no Python setup needed.
# To test the MCP endpoint directly:
import requests, os
API_KEY = os.environ['SCAVIO_API_KEY']
r = requests.post('https://api.scavio.dev/api/v1/search',
headers={'x-api-key': API_KEY},
json={'query': 'opencode CLI web search'})
print(r.json().get('organic_results', [])[:3])JavaScript 示例
JavaScript
// opencode discovers tools from mcp.json; no JS code required.
// Direct API call for parity:
const API_KEY = process.env.SCAVIO_API_KEY;
const r = await fetch('https://api.scavio.dev/api/v1/search', {
method: 'POST',
headers: { 'x-api-key': API_KEY, 'Content-Type': 'application/json' },
body: JSON.stringify({ query: 'opencode CLI web search' })
});
console.log(((await r.json()).organic_results || []).slice(0, 3));预期输出
JSON
opencode CLI exposes scavio_* tools in /tools. The agent calls them automatically when the user question needs live data.