cxws-mcp exposes the Codex standalone cloud-search endpoint as 11
intent-oriented MCP tools. It is a single Rust binary with stdio and MCP
Streamable HTTP transports. Each process uses the operator's own API base URL,
key, and model.
[!WARNING]
/alpha/search is an experimental upstream API. Providers can remove it or
change its schema. cxws-mcp fails clearly on incompatible responses and does
not silently fall back to another search provider.
A standalone MCP server for Codex cloud web search
स्टार
1
टूल
—
अपटाइम
—
Requirements
Rust 1.90 or newer to build from source
An OpenAI-compatible provider that implements <base-url>/alpha/search
A model accepted by that endpoint
Install
cargo install --path .
The binary is named cxws-mcp.
Configuration
Purpose
Environment
CLI
Required
Upstream base URL
CXWS_BASE_URL
--base-url
yes
Upstream API key
CXWS_API_KEY
none
yes
Upstream model
CXWS_MODEL
--model
yes
Log filter
CXWS_LOG
none
no
Expose advanced web_run
CXWS_EXPOSE_WEB_RUN
--expose-web-run
no
CLI base URL and model values override their environment variables. The API key
is environment-only so it does not appear in process listings or shell history.
Logs go to stderr and never include the key or upstream response bodies.
Base URLs must use HTTPS. Plain HTTP is accepted automatically for localhost
and literal loopback addresses; use --allow-insecure-http for any other
operator-controlled HTTP endpoint. User information, query strings, and
fragments in the base URL are rejected. Upstream redirects are disabled.
Reqwest honors standard proxy variables such as HTTPS_PROXY and NO_PROXY.
Readiness is available at GET /healthz. The HTTP mode has no TLS or client
authentication and defaults to loopback. For remote use, place an authenticated
reverse proxy in front of it; see the Nginx guide.
The server uses tower-mcp for negotiated MCP protocol versions, including
stable 2025-11-25 initialization and the 2026-07-28 discovery lifecycle. It does
not implement the legacy standalone HTTP+SSE transport.
Tool Selection
Intent
Tool
Fetch a specific HTTP(S) URL
web_fetch
Discover webpages
web_search
Open/click/find/render a returned turn... reference
Dependent navigation calls should be sequential. A pure URL passed to
web_search fails locally and tells the model to use web_fetch, without
spending upstream quota.
For 0.1 compatibility, set CXWS_EXPOSE_WEB_RUN=true or pass
--expose-web-run. The low-level tool is then appended as tool 12. Reconnect or
restart the MCP client after changing exposure so it refreshes tools/list.
Migration is direct: search_query -> web_search, literal open ->
web_fetch, referenced open/click/find/screenshot -> the matching
navigation tool, and image/finance/weather/sports/time fields -> their matching
search or lookup tool.
Limits
four web_search/image_search queries; four require medium or long output
16 operations per call
20 domains per query
8 KiB per text operand and 64 KiB of context
1 MiB validated tool arguments and HTTP request bodies
120-second upstream request timeout
8 MiB total upstream response and 1 MiB plaintext output
2 MiB structured results; larger metadata is omitted with
results_omitted: true
The stdio transport is intended for trusted local clients. The transport can
buffer a JSON line before semantic validation, so the 1 MiB raw HTTP limit has
no exact pre-parse stdio equivalent.
Errors
The tools distinguish invalid arguments, authentication failures, rate limits,
timeouts, transport failures, malformed or oversized responses, and upstream
HTTP failures. A 404 advises checking both CXWS_BASE_URL and provider support
for /alpha/search. No request is retried automatically.
अभी टूल सूची नहीं है। रिमोट सर्वर को पहले हेल्थ चेक के बाद सूची मिलती है।
FAQ
सवाल
Cxws कैसे इंस्टॉल करें?
इस पेज पर Cursor, Claude Desktop, Claude Code या VS Code के लिए stdio कॉन्फ़िग कॉपी करें। यह पब्लिशर का इंस्टॉल इस्तेमाल करता है, PlugMCP प्रॉक्सी नहीं।
क्या Cxws के लिए API key चाहिए?
इस रिकॉर्ड में कोई ज़रूरी एनवायरनमेंट वेरिएबल दर्ज नहीं है।
Cxws कौन सा ट्रांसपोर्ट इस्तेमाल करता है?
Cxws stdio पर लोकल चलता है।
Cxws की पिछली जाँच कब हुई थी?
पिछली जाँच 2026-10-28 को हुई। A standalone MCP server for Codex cloud web search