CPA Search MCP Server
This MCP server enables real-time web search and webpage content extraction for AI agents using your local CPA credentials.
Web search (
cpa_search): Find current facts, documentation, and technical news usinggemini,glm,grok,duckduckgo, orautofailover.Webpage extraction (
fetch_webpage): Fetch any HTTP/HTTPS URL and convert raw HTML into clean readable text.Proxy-aware networking: Live-web requests can tunnel through configured HTTP proxies or fall back to direct connections.
Universal MCP compatibility: Integrates with Claude Code, Cursor, Codex, Windsurf, Trae, and other MCP clients with zero extra dependencies.
Provides free public web search as an engine option without requiring API keys.
Provides real-time web search and fact verification using Google's Gemini model, including deep web search.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@CPA Search MCP Server search for latest TypeScript 5.7 release notes"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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: 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, tryingCPA_SEARCH_PROXY→HTTPS_PROXY/HTTP_PROXY/ALL_PROXY→http://127.0.0.1:7897→ direct.🌐 Webpage Content Extraction: Includes a built-in
fetch_webpagetool 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 list2. 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 |
|
| Local CPA proxy address |
| (Built-in Local Key) | CPA authentication key |
|
| Gemini model used with native |
|
| Model used by the |
| (see chain below) | Explicit outbound proxy for live-web fetches; set to an empty string to force direct connection |
| falls back to | Outbound proxy for live-web fetches ( |
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 toolscpa_searchA
使用本地已登录的 Gemini / Grok / GLM 账号进行实时全网搜索,获取最新技术动态、文档与事实总结,并附带权威来源。
Inputs: query (required), engine.
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
Scored across 2 tools
两个工具功能明确分离:cpa_search用于搜索并返回结果,fetch_webpage用于抓取特定URL的内容。没有重叠或模糊边界,代理可以轻松区分何时使用哪个工具。
两个工具均使用snake_case,且都包含动作词(search, fetch),但cpa_search以名词cpa开头,而fetch_webpage以动词开头,存在轻微不一致。不过整体模式简单且可预测,不影响理解。
仅2个工具对于搜索服务器而言显得单薄,但结合其功能(搜索+网页抓取)已覆盖核心需求。未超出合理范围,但处于评分的下限。
搜索和网页抓取共同构成完成查询-获取详情的基本流程,没有明显缺失的关键操作。但缺少如历史记录、批量处理等扩展功能,仍有小幅度提升空间。
Maintenance
Related MCP Connectors
Web search, Google SERP, page extraction to markdown and cited answers for AI agents.
Web search and page reading for AI agents with zero API credits
Web search and page reading for AI agents: search, fetch, scrape, map and crawl, with sources.
Web search and page reading for AI agents, including JSON APIs, RSS feeds and YouTube.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables 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,209MIT
- FlicenseNot gradedqualityDmaintenanceEnables AI agents to search the web via DuckDuckGo and fetch relevant webpage content using an LLM, without requiring an API key.-
- FlicenseNot gradedqualityDmaintenanceEnables 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.-
- AlicenseNot gradedqualityDmaintenanceProvides 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 npmMIT