anysearch-ai/anysearch-mcp-server

AnySearch MCP 服务器

它是什么 – 一个轻量级的 HTTP MCP（模型上下文协议）服务器，让 AI 编程助手（OpenCode、Claude Code、Cursor、VS Code、Cline、OpenAI Codex、Google Antigravity、DeepSeek Harness、Hermes Agent、Oh My Pi 等）能够执行实时网络搜索、特定领域搜索、批量搜索和整页内容提取。

为什么重要 – 现代基于 LLM 的智能体需要最新信息。AnySearch MCP 暴露了一个单一端点（https://api.anysearch.com/mcp），返回结构化工具调用（search、get_sub_domains、batch_search、extract）。该服务器支持可选 API 密钥（更高速率限制）或匿名访问（较低限制），开箱即用，适用于演示和生产环境。

---

核心能力

能力	你可以做什么
通用网络搜索	发送自然语言查询，最多返回 10 条结果。
垂直领域搜索	查询金融、学术、安全、法律、代码等结构化数据 – 首先调用 get_sub_domains 发现允许的子域及其参数模式。
并行批量搜索	在单个请求中运行 1-5 个独立搜索；失败相互隔离。
URL 内容提取	检索完整 HTML 页面并返回为 Markdown（截断至 50k 字符）。
匿名访问	无需 API 密钥；服务器仍响应所有调用，但执行更严格的速率限制。

---

获取 API 密钥（可选）

1. 一键注册 – 向 https://api.anysearch.com/v1/auth/email/register 发送 POST 请求，使用真实可用的邮箱。响应包含一次性明文密钥。
2. 仪表板 – 或者，在 https://anysearch.com/console/api-keys 创建密钥。
3. 密钥优先级 – CLI 标志 > ANYSEARCH_API_KEY 环境变量 > .env 文件 > 匿名。

提示： 将密钥存储在环境变量或密钥管理器中；切勿将其提交到源代码。

---

如何连接（MCP 客户端示例）

所有客户端使用相同的远程端点并发送两个标头：

Authorization: Bearer <YOUR_KEY>   # 匿名时省略
X-Anysearch-Client: mcp/1.0.0

以下是大多数常见智能体的最小配置片段。

OpenCode（全局）

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "anysearch": {
      "type": "remote",
      "url": "https://api.anysearch.com/mcp",
      "enabled": true,
      "oauth": false,
      "headers": {
        "Authorization": "Bearer {env:ANYSEARCH_API_KEY}",
        "X-Anysearch-Client": "mcp/1.0.0"
      }
    }
  }
}

运行 opencode mcp list 验证。

Claude Code（用户级）

claude mcp add --transport http anysearch https://api.anysearch.com/mcp \
  --scope user \
  --header 'Authorization: Bearer ${ANYSEARCH_API_KEY}' \
  --header 'X-Anysearch-Client: mcp/1.0.0'

对于项目级配置，创建包含相同字段的 .mcp.json。

Cursor（项目）

{
  "mcpServers": {
    "anysearch": {
      "url": "https://api.anysearch.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:ANYSEARCH_API_KEY}",
        "X-Anysearch-Client": "mcp/1.0.0"
      }
    }
  }
}

在 Customize > MCPs 下检查。

VS Code（安全提示）

{
  "inputs": [{
    "type": "promptString",
    "id": "anysearch-api-key",
    "description": "AnySearch API key",
    "password": true
  }],
  "servers": {
    "anysearch": {
      "type": "http",
      "url": "https://api.anysearch.com/mcp",
      "headers": {
        "Authorization": "Bearer ${input:anysearch-api-key}",
        "X-Anysearch-Client": "mcp/1.0.0"
      }
    }
  }
}

匿名使用时删除 Authorization 行。

（README 提供了 Cline、OpenAI Codex、Google Antigravity、DeepSeek Harness、Hermes Agent 和 OMP 的类似片段 – 所有都遵循相同的标头模式。）

---

工具契约（服务器期望和返回的内容）

search

{
  "query": "string",               // 必填，单一意图
  "domain": "finance"?,            // 可选垂直领域
  "sub_domain": "finance.us_stock"?,
  "sub_domain_params": {…}?,        // 必须匹配 get_sub_domains 的模式
  "max_results": 10                 // 1-10，默认 10
}

get_sub_domains

{ "domain": "finance" }   // 或 "domains": ["finance","academic"]

返回 Markdown 表格 sub_domain | description | params。

batch_search

{ "queries": [ {…search-object…}, {…} ] }

最多五个查询；每个遵循 search 模式。

extract

{ "url": "https://example.com" }

返回页面内容为 Markdown（最大 50k 字符）。

---

速率限制与错误处理（如 README 所述）

情况	推荐响应
注册时邮箱无效	提示用户重新输入有效地址。
409 / email_already_registered	告知用户通过提供的 login_url 登录；不要重试。
429（速率受限）	遵守 Retry-After 标头或消息；必要时回退到匿名模式。
Key creation failed…	从消息中提取邮箱和 URL，并要求用户手动创建密钥。
500 内部错误	稍后重试或切换到匿名访问。

---

何时使用

• 智能体驱动的研究 – 需要最新网络数据的 LLM 可以直接从 IDE 调用 search 或 extract。
• 特定领域工作流 – 金融分析师、法律研究人员或开发者可以先调用 get_sub_domains 发现其垂直领域的精确模式。
• 批处理 – 使用 batch_search 并行运行多个独立查询以减少往返。
• 演示或原型 – 无需 API 密钥；只需将客户端指向端点。

---

限制

• 匿名模式执行更严格的速率限制（具体数字因账户而异）。
• extract 仅适用于 HTML 页面，并截断至 50k 字符。
• 服务器不托管任何模型；它纯粹是搜索工具提供者。
• 错误必须从 HTTP 状态、code 或 message 字段解释 – 没有统一的错误对象。

---

快速入门清单

1. （可选）通过一键邮箱流程注册 API 密钥。
2. 在环境中设置 ANYSEARCH_API_KEY 或将其添加到客户端特定配置文件中。
3. 为你的首选 IDE/智能体添加 MCP 服务器配置（见上方片段）。
4. 使用客户端的 mcp list / mcp test 命令验证连接。
5. 从你的 LLM 驱动工具调用 search、get_sub_domains、batch_search 或 extract。

---

底线 – AnySearch MCP 服务器是一个即用型、符合标准的桥梁，为 LLM 智能体提供对开放网络和许多垂直数据源的即时、结构化访问，具有简单的密钥管理和广泛的 IDE 支持。