MCP-Hive Proxy

Provides a gateway to MCP-Hive and exposes MCP servers locally with discovery and tool access.

typescript

0

GitHub Stars

typescript

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "mcp-hive-mcp-hive-proxy": {
      "command": "node",
      "args": [
        "src/proxy/mcpHiveProxy.ts",
        "--server",
        "<server-name>",
        "--local",
        "--credentials",
        "<credentials>"
      ]
    }
  }
}

The MCP-Hive Proxy serves as a gateway to MCP-Hive and other MCP servers, enabling you to connect to specific MCP servers or expose all available MCPs through a single, locally accessible interface. This makes it easier to manage credentials and access multiple MCP services from one entry point.

How to use

You can run the proxy in two modes. To connect to a specific MCP server, start the proxy in server mode and point it to the desired server with credentials. To expose all MCP servers through a single gateway, start the proxy in gateway mode and provide credentials.

How to use

Server mode proxies a single MCP by name for your MCP client. This is useful when you want a direct link to one server through your local environment.

node src/proxy/mcpHiveProxy.ts --server <server-name> --local --credentials <credentials>

How to use

Gateway mode exposes all available MCP servers through a single local proxy, providing namespaced tools for easy access and discovery.

node src/proxy/mcpHiveProxy.ts --gateway --local --credentials <credentials>

How to use

In gateway mode you have access to discovery tools and the server tools are namespaced. Discovery tools include the ability to discover servers and list tools, resources, and prompts. Server tools are accessed using a namespaced pattern like serverName___toolName (for example, validator___echo or accuweather___getWeather).

How to install

Prerequisites: ensure you have Node.js installed on your system (recommended community-supported versions). You also need npm to install and run the proxy.

Step 1: Navigate to the proxy directory where the MCP-Hive Proxy code resides.

# Install dependencies for the proxy package
npm install

# Start in server mode for a specific MCP server
node src/proxy/mcpHiveProxy.ts --server <server-name> --local --credentials <credentials>

# Or start in gateway mode to expose all MCP servers
node src/proxy/mcpHiveProxy.ts --gateway --local --credentials <credentials>

Additional notes

The proxy supports local execution and credentials-based authentication. In gateway mode, you will see discovery tools and namespaced server tools as described.

Tools and capabilities

Discovery tools are available to help you understand the MCP landscape and access options.

List of available tools

discoverServers: Discover available MCP servers in your environment.
listTools: List all available tools across the exposed MCPs.
listResources: List resources provided by the MCPs.
listPrompts: List available prompts for user interactions.

Namespaced server tools (accessed as serverName___toolName) examples include: validator___echo and accuweather___getWeather.

These tools enable you to interact with specific MCP server capabilities through the gateway interface.

Available tools

discoverServers

Discover available MCP servers in your environment.

listTools

List all available tools across the exposed MCPs.

listResources

List resources provided by the MCPs.

listPrompts

List available prompts for user interactions.

validator___echo

Namespaced tool for the validator server to echo input or responses.

accuweather___getWeather

Namespaced tool for the accuweather server to request weather data.