CPA Search MCP Server

English | 中文说明

一个轻量级、零依赖的 Model Context Protocol (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 / Windsurf / 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 (string, required)：搜索词或研究主题。

• engine (string, optional)：gemini | glm | grok | duckduckgo | auto。

2. fetch_webpage

获取并从任何 URL 中提取清晰的纯文本。

参数：

• url (string, required)：网页 URL（http/https）。

⚙️ 环境变量（可选）

🧪 测试

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

node test.mjs

📄 许可证

MIT License © 2026 ffffhx