CPA Search MCP Server

English | 中文说明

一个轻量级、零依赖的模型上下文协议（MCP）服务器，用于实时网络搜索和网页内容提取。

它能够无缝复用你本地的 CLIProxyAPI (CPA) 实例（http://127.0.0.1:8317）以及已授权的 Google Gemini、xAI Grok、Zhipu GLM 账户，为 AI 编程智能体（Claude Code、Cursor、Codex、Windsurf、Trae）执行结构化的网络研究。

🌟 核心特性

• ⚡ 零配置、零额外成本：直接使用你现有的本地 CPA 和 Google/Grok/GLM 凭据。

• 🎯 多引擎支持：

  • gemini：Google 深度网络搜索与事实核查（默认且推荐）。

  • glm：Zhipu GLM 中文及技术事实搜索。

  • grok：xAI 实时网络与 X/Twitter 搜索。

  • duckduckgo：无需任何 API 密钥的免费公共搜索引擎回退方案。

  • auto：自动选择请求引擎并支持故障转移。

• 🌐 网页内容提取：内置 fetch_webpage 工具，可获取网页并去除原始 HTML，转换为清晰可读的文本。

• 🔌 通用兼容性：适用于 Claude Code、Cursor、Codex、Windsurf、Trae 以及任何标准 MCP 客户端。

• 🚀 零依赖：纯 Node.js ESM 标准库实现，启动快、内存占用极小。

📦 快速开始

1. 在 Claude Code 中注册

在终端中运行以下命令：

claude mcp add --scope user cpa-search node "C:/Users/aa182/Documents/Codex/2026-08-22/new-chat-2/repositories/cpa-search-mcp/index.mjs"

验证状态：

claude mcp list

2. 为 Cursor / Trae / Codex 进行配置

在 MCP 配置文件（例如 claude_desktop_config.json 或 Cursor MCP 设置）中添加以下内容：

{
  "mcpServers": {
    "cpa-search": {
      "command": "node",
      "args": [
        "C:/Users/aa182/Documents/Codex/2026-08-22/new-chat-2/repositories/cpa-search-mcp/index.mjs"
      ]
    }
  }
}

🛠️ 提供的工具

1. cpa_search

在网络上搜索最新的事实、文档和技术资讯。

• 参数：

  • query（字符串，必填）：搜索查询或研究主题。

  • engine（字符串，可选）：gemini | glm | grok | duckduckgo | auto

2. fetch_webpage

从任意 URL 获取并提取干净的文本内容。

• 参数：

  • url（字符串，必填）：网页 URL（http/https）。

⚙️ 环境变量（可选）

🧪 测试

运行自动化端到端测试套件：

node test.mjs

📄 许可证

MIT License © 2026 ffffh5