CPA Search MCP Server

English | 中文说明

A lightweight, zero-dependency Model Context Protocol (MCP) server for real-time web search and webpage content extraction.

It seamlessly reuses your existing local CLIProxyAPI (CPA) instance (http://127.0.0.1:8317) and authorized Google Gemini, xAI Grok, Zhipu GLM accounts to perform structured web research for AI coding agents (Claude Code, Cursor, Codex, Windsurf, Trae).

🌟 Key Features

• ⚡ Zero Setup & Zero Extra Cost: Directly uses your existing local CPA and Google/Grok/GLM credentials.

• 🎯 Multi-Engine Support:

  • gemini: Google deep web search and fact verification (Default & Recommended).

  • glm: Zhipu GLM Chinese and technical fact search.

  • grok: xAI real-time web & X/Twitter search.

  • duckduckgo: Free public search engine fallback without any API keys.

  • auto: Intelligent automatic engine routing and failover.

• 🌐 Webpage Content Extraction: Includes a built-in fetch_webpage tool to fetch and strip raw HTML into clean readable text.

• 🔌 Universal Compatibility: Works with Claude Code, Cursor, Codex, Windsurf, Trae, and any standard MCP client.

• 🚀 Zero Dependencies: Pure Node.js ESM standard library implementation. Instant startup and minimal memory footprint.

📦 Quick Start

1. Register with Claude Code

Run the following command in your terminal:

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"

Verify status:

claude mcp list

2. Configure for Cursor / Windsurf / Trae / Codex

Add the following to your MCP configuration file (e.g. claude_desktop_config.json or Cursor MCP settings):

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

🛠️ Provided Tools

1. cpa_search

Search the web for up-to-date facts, documentation, and technical news.

• Parameters:

  • query (string, required): The search query or research topic.

  • engine (string, optional): gemini | glm | grok | duckduckgo | auto.

2. fetch_webpage

Fetch and extract clean text from any URL.

• Parameters:

  • url (string, required): The webpage URL (http/https).

⚙️ Environment Variables (Optional)

🧪 Testing

Run the automated end-to-end test suite:

node test.mjs

📄 License

MIT License © 2026 ffffhx