内容
# 侦察 MCP 服务器
为您的编码代理提供实时网络。侦察的MCP服务器添加了网页搜索、刮取Markdown、结构化提取、爬取、截图和公司查找等工具，任何MCP客户端都可以调用这些工具：Claude Code、Codex、Gemini CLI、Antigravity、Cursor、Windsurf和Claude Desktop。
它具有**零依赖** — MCP协议在几百行纯JavaScript中实现，无需构建步骤，安装时也不会从npm中拉取任何内容。当您运行它时，唯一运行的代码是此仓库中的代码。参见[安全.md](./SECURITY.md)。
## 工具
| 工具 | 功能 |
|------|--------------|
| `scout_search` | 搜索实时网络；返回JSON格式的排名结果。`depth: "deep"`运行一个代理多步骤搜索。 |
| `scout_scrape` | 获取一个页面作为干净的、LLM-ready Markdown（处理JS + 机器人防御）。 |
| `scout_extract` | 从一个或多个URL中提取结构化数据，以实现特定目标。 |
| `scout_crawl` | 从起始URL爬取网站，限制在`max_pages`内。 |
| `scout_screenshot` | 捕获页面截图。 |
| `scout_company` | 从域名获取公司简介（名称、行业、社交媒体、徽标）。 |
| `scout_answer` | 通过阅读页面及其链接的页面来回答问题。 |
| `scout_find_all` | 构建一个与自然语言查询匹配的实体列表。 |
## 获取密钥
在[platform.usescout.sh/settings](https://platform.usescout.sh/settings)上创建API密钥，并将其设置为`SCOUT_API_KEY`。下面的每个示例都使用`npx`，因此无需先安装。
## 按客户端安装
### Claude Code
```sh
claude mcp add scout --env SCOUT_API_KEY=sk_your_key -- npx -y @scout-ai/mcp
```
### Codex CLI
添加到 `~/.codex/config.toml`:
```toml
[mcp_servers.scout]
command = "npx"
args = ["-y", "@scout-ai/mcp"]
env = { SCOUT_API_KEY = "sk_your_key" }
```
### Gemini CLI
添加到 `~/.gemini/settings.json`:
```json
{
"mcpServers": {
"scout": {
"command": "npx",
"args": ["-y", "@scout-ai/mcp"],
"env": { "SCOUT_API_KEY": "sk_your_key" }
}
}
}
```
### Antigravity
在MCP设置中，添加一个具有以下配置的服务器（或将其粘贴到MCP配置文件中）：
```json
{
"mcpServers": {
"scout": {
"command": "npx",
"args": ["-y", "@scout-ai/mcp"],
"env": { "SCOUT_API_KEY": "sk_your_key" }
}
}
}
```
### Cursor
添加到 `.cursor/mcp.json`（项目）或 `~/.cursor/mcp.json`（全局）：
```json
{
"mcpServers": {
"scout": {
"command": "npx",
"args": ["-y", "@scout-ai/mcp"],
"env": { "SCOUT_API_KEY": "sk_your_key" }
}
}
}
```
### Windsurf
添加到 `~/.codeium/windsurf/mcp_config.json`:
```json
{
"mcpServers": {
"scout": {
"command": "npx",
"args": ["-y", "@scout-ai/mcp"],
"env": { "SCOUT_API_KEY": "sk_your_key" }
}
}
}
```
### Claude Desktop
使用与上述相同的 `mcpServers` 块添加到 `claude_desktop_config.json`（设置 → 开发者 → 编辑配置）。
## 使用它
连接后，询问您的代理类似的问题：
- "搜索有关欧盟人工智能法案的最新信息，并总结排名前5的来源。"
- "刮取 https://example.com/pricing 并提取计划名称和价格。"
- "查找 stripe.com 并告诉我他们的行业和社交媒体信息。"
代理选择合适的侦察工具并调用它。
## 长任务进度
`scout_search` 使用 `depth: "deep"` 运行一个代理多步骤搜索服务器端。服务器流式传输侦察的运行事件，并将其转发为MCP进度通知，因此显示进度的客户端（Claude Code、Cursor）显示实时更新，而不是冻结的旋转器。最终结果在运行完成时返回。
## 主机HTTP/SSE传输
除了stdio外，服务器还可以通过MCP的Streamable HTTP传输在HTTP上运行，因此远程客户端可以通过URL连接：
```sh
SCOUT_API_KEY=sk_your_key npx -y -p @scout-ai/mcp scout-mcp-http
# 监听 :3000/mcp
```
| 变量 | 默认值 | 目的 |
|----------|---------|---------|
| `PORT` | `3000` | 监听端口。 |
| `SCOUT_MCP_PATH` | `/mcp` | 端点路径。 |
| `SCOUT_MCP_TOKEN` | （无） | 如果设置，客户端必须发送 `Authorization: Bearer <token>`。 |
将MCP客户端指向 `http://your-host:3000/mcp`。有一个 `/health` 端点用于负载均衡器。每个请求都是无状态的（每个请求都有一个全新的服务器），这使得它可以简单地在任何HTTP前端运行。
## 配置
| 变量 | 默认值 | 目的 |
|----------|---------|---------|
| `SCOUT_API_KEY` | （必填） | 您的侦察API密钥。 |
| `SCOUT_BASE_URL` | `https://core.usescout.sh` | 覆盖API源。 |
## 从源代码运行
无需安装，无需构建（零依赖）：
```sh
SCOUT_API_KEY=sk_your_key node bin/scout-mcp.js # stdio
SCOUT_API_KEY=sk_your_key node bin/scout-mcp-http.js # 主机HTTP/SSE
node test/smoke.mjs # 运行协议测试
```
## 许可证
[MIT](./LICENSE)
