Hydra MCP

by keyboardsmoke

3 stars
222 downloads
Not rated
GitHub

About

Just a test project for an intermediate server between endpoints and Claude's MCP

Details

Author
keyboardsmoke
GitHub stars
3
Downloads
222
Categories
Other, AI

- Centralized function registry for multiple clients
- REST API endpoints for function discovery and invocation
- Standardized communication protocol between clients and Claude
- Easy-to-use function registration system
- Automatic function discovery and documentation

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Hydra MCP
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Start the central server by running python ipc_server.py. Register client functions by sending a POST request to /register_functions with an endpoint name and function list. Then use the MCP tools (get_endpoints(), get_registered_functions(), call_function()) to discover and invoke functions from Claude.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "hydra mcp": {
            "hydra-mcp": {
                "command": "python",
                "args": [
                    "ipc_server.py"
                ]
            }
        }
    }
}

McpServers

{
    "hydra-mcp": {
        "command": "python",
        "args": [
            "ipc_server.py"
        ]
    }
}

Hydra MCP

This project implements a Hydra MCP (Model Control Protocol) server that enables Claude to interact with various client functions through a REST API interface. The system consists of a central server that coordinates communication between multiple clients and exposes their functions to Claude through a standardized API.

Claude using the Hydra MCP plugin

Project Structure

- ipc_server.py: The central FastAPI server that manages function registration and routing
- ipc_api.py: The Hydra MCP interface that exposes client functions to Claude
- fake_client.py: A sample client implementation for testing
- fake_claude.py: A test implementation of Claude's interface

Features

- Centralized function registry for multiple clients
- REST API endpoints for function discovery and invocation
- Standardized communication protocol between clients and Claude
- Easy-to-use function registration system
- Automatic function discovery and documentation

API Endpoints

Server Endpoints

- POST /register_functions: Register new functions from a client
- GET /get_functions: Retrieve the list of all registered functions

MCP Tools

- get_endpoints(): List all available endpoints
- get_registered_functions(endpoint): Get functions available at a specific endpoint
- call_function(endpoint, function_name, arguments): Call a specific function with arguments

Usage

1. Start the central server:

python ipc_server.py

2. Register client functions:
```python

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.