MCP Gateway

Model Context Protocol (MCP) Gateway - A tool management and execution service.

Overview

MCP Gateway provides a central service for registering, discovering, and executing various tools. It acts as a gateway between applications and specialized tools, offering a standardized interface for tool execution.

Features

Tool discovery and registration
Standardized tool execution interface
Support for multiple tool types:
- Calculator for mathematical operations
- Text analyzer for text processing
- Weather forecast for retrieving weather information

Architecture

The MCP Gateway follows a modular architecture:

Tools Registry: Central repository of all available tools
Tool Handlers: Implementations for specific tool functionalities
Protocol Layer: REST API for tool discovery and execution

How to Use

Running the Gateway

mvn clean package
java -jar target/mcp-gateway-0.0.1-SNAPSHOT.jar

The gateway will start on port 8080 by default.

Available Endpoints

Tool Management

GET /mcp/api/tools - List all available tools
GET /mcp/api/tools/{toolName} - Get details about a specific tool
POST /mcp/api/tools/{toolName}/execute - Execute a specific tool

Health Check

GET /mcp/api/health - Check gateway health

Example Requests

List Tools

curl -X GET http://localhost:8080/mcp/api/tools

Execute Calculator

curl -X POST http://localhost:8080/mcp/api/tools/calculator/execute \
  -H "Content-Type: application/json" \
  -d '{"operation": "add", "a": 10, "b": 5}'

Configuration

Configuration options in application.properties:

# Server Configuration
server.port=8080
server.servlet.context-path=/mcp/api

# Logging Configuration
logging.level.com.mcp.mcpgateway=DEBUG

Extending with New Tools

To add a new tool to the gateway:

Create a new implementation of the ToolHandler interface
Register the tool handler as a Spring component
The tool will be automatically discovered and made available via the API

MCP-Project/gateway

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Languages

Packages