# Grok Native Search MCP

一个极简的 stdio MCP Server，提供三个只读工具：

- `web_search(query)`：Grok 原生 Web Search
- `x_search(query)`：Grok 原生 X Search
- `web_fetch(url)`：Jina Reader 网页转 Markdown

搜索固定使用 `grok-4.6`、`reasoning.effort: low` 和 `max_turns: 2`。搜索从一个聚焦查询开始，
找到足够的一手证据后停止，仅在证据缺失或冲突时扩大范围。工具响应不做解析或改写，直接作为
MCP 文本返回。

工具路由：已知 URL 或需要核验页面正文时使用 `web_fetch`；X 帖子、账号、线程和趋势使用
`x_search`；尚无明确 URL 的其他全网检索使用 `web_search`。搜索得到需要核验的外部 URL 后，
继续调用 `web_fetch`。

## 环境变量

| 变量 | 用途 |
| --- | --- |
| `XAI_API_KEY` | xAI 或兼容网关的 API Key |
| `XAI_BASE_URL` | 可选，Responses API 基础地址；默认使用 `https://aiapiv2.kamipon.com:442/v1` |
| `JINA_API_KEY` | Jina Reader API Key |
| `HTTP_PROXY` / `HTTPS_PROXY` / `NO_PROXY` | 可选，仅供 Jina Reader 请求使用的环境代理配置 |

## 使用 npx 启动

```bash
npx -y grok-native-search-mcp@latest
```

## Codex 配置

```toml
[mcp_servers.grok_native_search]
command = "npx"
args = ["-y", "grok-native-search-mcp@latest"]
env_vars = ["XAI_API_KEY", "JINA_API_KEY", "HTTP_PROXY", "HTTPS_PROXY", "NO_PROXY"]
```

配置后重启 Codex。

## 本地开发

```bash
npm install
npm test
```