Kuma-MCP-server

adarsh1405/Kuma-MCP-server

3.2

If you are the rightful owner of Kuma-MCP-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

Kuma-MCP-server is a model context protocol server designed to facilitate communication and data exchange between different systems using the Model Context Protocol (MCP).

Kuma-MCP-server

Kuma-MCP-server is a lightweight, extensible server built with Python, designed to provide a modular control plane (MCP) for managing and monitoring distributed systems. The server exposes RESTful APIs for service registration, health checks, and status monitoring, making it suitable for microservices architectures and cloud-native environments.

Features

  • Service Registration: Register and deregister services dynamically.
  • Health Checks: Monitor the health of registered services.
  • Status Endpoints: Query the status and metadata of services.
  • Extensible Architecture: Easily add new endpoints and integrations.
  • Lightweight: Minimal dependencies and easy to deploy.

Getting Started

Prerequisites

  • Python 3.8+
  • pip for dependency management
  • Run kuma locallly / whereever you want
  • Download Claud or any local LLM which supports MCP server

Installation

git clone https://github.com/yourusername/Kuma-MCP-server.git
cd Kuma-MCP-server
pip install -r requirements.txt

Running the Server

python main.py

The server will start on http://localhost:8000 by default.

API Endpoints

MethodEndpointDescription
GET/servicesList all registered services
POST/registerRegister a new service
POST/deregisterDeregister a service
GET/healthHealth check for the server
GET/status/<name>Get status of a specific service
GET/metricsGet server metrics (if implemented)
GET/Root endpoint, usually returns welcome

Note: Endpoints may vary based on your main.py implementation. Please refer to the code for any custom or additional endpoints.

Example Usage

Register a service:

curl -X POST http://localhost:8000/register -H "Content-Type: application/json" -d '{"name": "service1", "address": "127.0.0.1", "port": 5000}'

Screenshots

dashboard policyCreation insights

Sample Video

Directory Structure

Kuma-MCP-server/
ā”œā”€ā”€ assets/
ā”‚   ā”œā”€ā”€ dashboard.png
ā”‚   ā”œā”€ā”€ ss1.png
ā”‚   ā”œā”€ā”€ ss2.png
ā”‚   ā””ā”€ā”€ demo.mp4
ā”œā”€ā”€ main.py
ā”œā”€ā”€ README.md
ā””ā”€ā”€ requirements.txt

License

This project is licensed under the MIT License.