Skip to main content
Glama
CPA Search MCP Server

CPA Search MCP Server

by ffffhx

CPA Search MCP Server

License: MIT Node.js MCP

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: Official Google Search Grounding via CPA's native Gemini endpoint, including returned Grounding sources and search queries.

    • glm: Chinese & local tech research via Zhipu GLM-5.3 (fresher knowledge, deep-reasoning model; slower).

    • grok: xAI Grok knowledge with a real-time bias.

    • duckduckgo: Live-web scraper — scrapes DuckDuckGo HTML and automatically falls back to Bing when bot-challenged. No API keys.

    • auto: gemini → glm → live-web automatic failover.

  • 🛡️ Proxy-aware networking: live-web fetches (DuckDuckGo/Bing/fetch_webpage) tunnel through your HTTP proxy via zero-dependency CONNECT, trying CPA_SEARCH_PROXY → HTTPS_PROXY/HTTP_PROXY/ALL_PROXY → http://127.0.0.1:7897 → direct.

  • 🌐 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.


Related MCP server: DuckDuckGo MCP Server

📦 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)

Variable

Default

Description

CPA_BASE_URL

http://127.0.0.1:8317

Local CPA proxy address

CPA_API_KEY

(Built-in Local Key)

CPA authentication key

CPA_SEARCH_MODEL

gemini-3.8-flash-high

Gemini model used with native googleSearch Grounding

CPA_GLM_MODEL

glm-5.3-cpa

Model used by the glm engine

CPA_SEARCH_PROXY

(see chain below)

Explicit outbound proxy for live-web fetches; set to an empty string to force direct connection

HTTPS_PROXY

falls back to http://127.0.0.1:7897

Outbound proxy for live-web fetches (HTTPS_PROXY/HTTP_PROXY/ALL_PROXY are honored)

Proxy resolution order for live-web fetches: CPA_SEARCH_PROXY → HTTPS_PROXY/HTTP_PROXY/ALL_PROXY → local Clash/mihomo default (http://127.0.0.1:7897) → direct connection. Local addresses (CPA itself) always go direct.


🧪 Testing

Run the automated end-to-end test suite:

node test.mjs

📄 License

MIT License © 2026 ffffhx

Available Tools

2 tools
fetch_webpageC

直接抓取指定 URL 网页的完整正文内容并转换为易读的文本

Inputs: url (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 2 tools

    Disambiguation5/5

    两个工具功能明确分离:cpa_search用于搜索并返回结果,fetch_webpage用于抓取特定URL的内容。没有重叠或模糊边界,代理可以轻松区分何时使用哪个工具。

    Naming Consistency4/5

    两个工具均使用snake_case,且都包含动作词(search, fetch),但cpa_search以名词cpa开头,而fetch_webpage以动词开头,存在轻微不一致。不过整体模式简单且可预测,不影响理解。

    Tool Count3/5

    仅2个工具对于搜索服务器而言显得单薄,但结合其功能(搜索+网页抓取)已覆盖核心需求。未超出合理范围,但处于评分的下限。

    Completeness4/5

    搜索和网页抓取共同构成完成查询-获取详情的基本流程,没有明显缺失的关键操作。但缺少如历史记录、批量处理等扩展功能,仍有小幅度提升空间。

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables comprehensive web searching and content extraction using multiple search engines (Bing, Brave, DuckDuckGo) without API keys. Provides tools for full web searches with content extraction, quick search summaries, and single webpage content retrieval.
      1,209
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables AI agents to perform web searches, extract webpage content, and conduct end-to-end search-and-extract operations using multiple search providers and content extraction methods.
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides AI coding agents with a live web search tool that returns extracted, answer-ready text from web pages. Enables real-time information retrieval without any local installation or maintenance.
      4 npm
      MIT