Hydra MCP logo

Hydra MCP

by keyboardsmoke

Hydra MCP is a server that allows Claude to interact with various client functions through a REST API. It provides a centralized server to coordinate communication between multiple clients and expose their functions to Claude through a standardized API.

View on GitHub

Last updated: N/A

What is Hydra MCP?

Hydra MCP is a Model Control Protocol server designed to enable Claude (an AI model) to interact with various client functions. It acts as a central hub, managing function registration and routing requests between Claude and connected clients via a REST API.

How to use Hydra MCP?

To use Hydra MCP, first start the central server using python ipc_server.py. Then, register client functions by sending a POST request to the /register_functions endpoint. Finally, use the MCP interface (e.g., get_endpoints(), get_registered_functions(), call_function()) to interact with the registered functions.

Key features of Hydra MCP

  • Centralized function registry

  • REST API endpoints

  • Standardized communication protocol

  • Easy function registration

  • Automatic function discovery

Use cases of Hydra MCP

  • Extending Claude's capabilities

  • Integrating Claude with external services

  • Automating tasks with Claude

  • Building custom AI workflows

  • Controlling various applications through Claude

FAQ from Hydra MCP

What is the default port for the server?

The server runs on port 6565 by default.

How do I change the server port?

Modify the API_SERVER_PORT constant in both ipc_server.py and ipc_api.py.

What are the dependencies?

The project depends on FastAPI, uvicorn, requests, and fastmcp.

How do I test the functionality?

Use the sample implementations (fake_client.py and fake_claude.py) for testing.

What is the purpose of ipc_api.py?

ipc_api.py defines the Hydra MCP interface that exposes client functions to Claude.