Prepare the server locally
Run this once before adding it to Claude Code.
git clone https://github.com/MCP-Hive/mcp-hive-proxy
cd mcp-hive-proxyThen follow the repository README for any remaining dependency or build steps.
Register it in Claude Code
claude mcp add -e "credentials=${credentials}" mcp-hive-proxy -- node /path/to/mcp-hive-proxy/src/proxy/mcpHiveProxy.ts --gateway --credentials YOUR_CREDENTIALSReplace any placeholder paths in the command with the real path on your machine.
credentialsMake your agent remember this setup
mcp-hive-proxy's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.
npx conare@latestFree · one command · indexes the sessions already on disk. Set up in the browser instead →
What it does
- Proxy a specific MCP server to your MCP client
- Expose all available MCP servers through a single gateway
- Namespaced tool access (serverName___toolName)
- Built-in discovery tools for servers, tools, resources, and prompts
Tools 4
discoverServersList all available servers accessible through the proxy.listToolsList all tools available across connected MCP servers.listResourcesList all resources available across connected MCP servers.listPromptsList all prompts available across connected MCP servers.Environment Variables
credentialsrequiredConsumer credentials for authentication obtained from mcp-hive.comTry it
Original README from MCP-Hive/mcp-hive-proxy
MCP-Hive Proxy
This is the MCP-Hive Proxy. It can be loaded by any agentic host in order to access MCP-Hive and is a gateway to other MCP servers. To obtain credentials, and read further documentation, go to mcp-hive.com
Running
The proxy can run in two modes:
Server Mode (Single MCP)
Proxy a specific MCP server to your MCP client:
node src/proxy/mcpHiveProxy.ts --server <server-name> --local --credentials <credentials>
Gateway Mode (All MCPs)
Expose all available MCP servers through a single proxy with namespaced tools:
node src/proxy/mcpHiveProxy.ts --gateway --local --credentials <credentials>
In gateway mode:
- Discovery tools are available:
discoverServers,listTools,listResources,listPrompts - All server tools are namespaced:
serverName___toolName(e.g.,validator___echo,accuweather___getWeather)
Proxy Flags
| Flag | Description |
|---|---|
--server <name> |
Proxy a specific MCP server (omit for gateway mode) |
--gateway |
Explicitly enable gateway mode |
--http |
Run the proxy in HTTP transport |
--port |
Port number to be used if HTTP-transport |
--credentials <id> |
Consumer credentials for authentication |
--verbose |
Enable verbose logging |