README.md
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 |
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
→Discover all servers currently available through the MCP-Hive proxy.
→List all tools available in the gateway to see what I can interact with.
→Show me all resources provided by the connected MCP servers.
→List the available prompts I can use through the proxy.