A minimal, copy-and-run workspace that demonstrates the MCP Proxy feature.

It installs a single plugin (deepwiki) that exposes a real public HTTP MCP server (https://mcp.deepwiki.com/mcp), and proxies it through mcp-remote for Codex — which only supports stdio transport.

Scaffold a fresh copy anywhere with workspace init --from (recommended — this also runs the initial sync):

allagents workspace init ./mcp-proxy-demo \
  --from EntityProcess/allagents/examples/workspaces/mcp-proxy
cd ./mcp-proxy-demo

Or, if you have this repo checked out, run it in-place:

cd examples/workspaces/mcp-proxy
allagents update

Then inspect the generated files:

cat .mcp.json                 # HTTP config for Claude Code
cat .codex/config.toml        # Rewritten stdio config for Codex

You should see Codex invoking:

npx mcp-remote https://mcp.deepwiki.com/mcp --http \
  --static-oauth-client-metadata @~/.allagents/mcp-remote/mcp-metadata-settings.json

DeepWiki is a public, no-auth server, so you can connect immediately and ask questions like "What is the architecture of facebook/react?" from any proxied client.

• Node.js (provides npx, needed to run mcp-remote on demand). Nothing to install globally — npx fetches and caches mcp-remote automatically the first time a proxied server starts.

• MCP Proxy guide
• mcp-remote on npm