MCP Gateway Ygi

The MCP Gateway is an advanced AI infrastructure middleware solution that acts as a proxy gateway for model context protocol (MCP) servers, providing unified interfaces, sensitive information filtering, and lifecycle management functions.

Developer tools Security #AI Agent #Security Gateway #Protocol Management #Middleware .Python

rating : 3 points

downloads : 658

update time : 2025-04-23

What is the MCP Gateway?

The MCP Gateway acts as an intermediary, connecting LLMs and other MCP servers. It manages the server configuration file (mcp.json), intercepts requests and responses to protect sensitive information, and provides a unified interface to discover and interact with all proxied MCPs.

How to use the MCP Gateway?

By installing the MCP Gateway and configuring its plugins, you can easily manage and protect your MCP servers. You can get started in just a few steps.

Applicable Scenarios

The MCP Gateway is well - suited for enterprise environments that need to centrally manage multiple MCP servers, ensuring data security and operational efficiency.

Main Features

Read Server ConfigurationAutomatically read the mcp.json configuration file located in the root directory.

Manage MCP Server LifecycleCentrally manage all configured MCP servers.

Request and Response InterceptionClean and protect sensitive information.

Unified InterfaceProvide a unified interface to discover and interact with all proxied MCPs.

Advantages and Limitations

Advantages

Centrally manage multiple MCP servers.

Protect sensitive information from leakage.

Provide a unified interface to simplify the operation process.

Limitations

May increase a certain degree of system complexity.

Depend on the correct configuration file settings.

How to Use

Install the MCP Gateway

Install the MCP Gateway via pip.

Configure the MCP Gateway

Edit the mcp.json file to add your MCP server configuration.

Start the MCP Gateway

Run the MCP Gateway service.

Usage Examples

Case 1: Basic Security ProtectionUse the basic plugin to protect sensitive information.

Case 2: Xetrack PluginUse the Xetrack plugin to track tool calls.

Frequently Asked Questions

How to install the MCP Gateway?

Which plugins does the MCP Gateway support?

Related Resources

Official Documentation

The official documentation of the MCP protocol.

GitHub Repository

The source code repository of the MCP Gateway.

Installation

Copy the following command to your Client for configuration

{
  "mcpServers": {
      "mcp-gateway": {
          "command": "mcp-gateway",
          "args": [
              "--mcp-json-path",
              "~/.cursor/mcp.json",
              "--plugin",
              "basic",
              "--plugin",
              "xetrack"
          ],
          "servers": {
              "filesystem": {
                  "command": "npx",
                  "args": [
                      "-y",
                      "@modelcontextprotocol/server-filesystem",
                      "."
                  ]
              }
          }
      }
  }
}

{
  "mcpServers": {
      "mcp-gateway": {
          "command": "<python path>",
          "args": [
            "-m",
            "mcp_gateway.server",
            "--mcp-json-path",
            "<path to claude_desktop_config>",
            "--plugin",
            "basic"
          ],
          "servers": {
              "filesystem": {
                  "command": "npx",
                  "args": [
                      "-y",
                      "@modelcontextprotocol/server-filesystem",
                      "."
                  ]
              }
          }
      }
  }
}

{
  "mcpServers": {
      "mcp-gateway": {
          "command": "docker",
          "args": [
            "run",
            "--rm",
            "--mount", "type=bind,source=/Users/oro/Projects/playground/mcp-gateway,target=/app",
            "-i",
            "-v", "/Users/oro/.cursor/mcp.json:/config/mcp.json:ro",
            "-e", "LASSO_API_KEY=<LASSO_API_KEY>",
            "-v", "mcp-gateway-logs:/logs",
            "mcp/gateway:latest",
            "--mcp-json-path", "/config/mcp.json",
            "--plugin", "basic",
            "--plugin", "lasso"
          ],
          "servers": {
              "filesystem": {
                  "command": "npx",
                  "args": [
                      "-y",
                      "@modelcontextprotocol/server-filesystem",
                      "."
                  ]
              }
          }
      }
  }
}

{
  "mcpServers": {
      "mcp-gateway": {
          "command": "mcp-gateway",
          "args": [
              "--mcp-json-path",
              "~/.cursor/mcp.json",
              "-p",
              "lasso"
          ],
          "env": {
              "LASSO_API_KEY": "<lasso_token>"
          },
          "servers": {
              "filesystem": {
                  "command": "npx",
                  "args": [
                      "-y",
                      "@modelcontextprotocol/server-filesystem",
                      "."
                  ]
              }
          }
      }
  }
}

{
    "mcpServers": {
        "mcp-gateway": {
            "command": "mcp-gateway",
            "args": [
                "--mcp-json-path",
                "~/.cursor/mcp.json",
                "-p",
                "xetrack"
            ],
            "env": {
                "XETRACK_DB_PATH": "tracing.db",
                "XETRACK_LOGS_PATH": "logs/"                
            },
            "servers": {
                "filesystem": {
                    "command": "npx",
                    "args": [
                        "-y",
                        "@modelcontextprotocol/server-filesystem",
                        "."
                    ]
                }
            }
        }
    }
}

Note: Your key is sensitive information, do not share it with anyone.

🚀 MCP Gateway

The MCP Gateway is a central router and management system that manages all connected MCPs (Micro Service Processes). It can act as a reverse proxy, handle external requests, and route these requests to appropriate backend services. Additionally, it offers a range of security protection, tracking, and monitoring functions.

🚀 Quick Start

The MCP Gateway serves as a central router and management system for all connected MCPs. It functions as a reverse proxy, handling external requests and routing them to the appropriate backend services. It also provides security protection, tracking, and monitoring features.

✨ Features

Unbiased Guardrails: Apply configurable security filters to all requests and responses to prevent the leakage of sensitive data.
Unified Visualization: Centralize the management and monitoring of all MCPs through a graphical interface, including risk assessment, real - time status, and performance metrics.
Advanced Tracing: Keep detailed logs of all requests and responses, support distributed tracing using Jaeger, and provide cost tracking and log aggregation functions.

📚 Documentation

1. Reverse Proxy

The MCP Gateway works as a reverse proxy, handling external requests. It applies a series of security filters, sanitizes the request content (e.g., replaces API keys), and then forwards the request to the corresponding backend service. When the response is returned, the gateway also sanitizes the content to prevent the leakage of sensitive information.

2. MCP Management Console

A graphical interface for managing and monitoring all connected MCPs. You can view the real - time status, performance metrics of each MCP, and conduct risk assessments.

3. Security Protection Plugin (Guardrails)

Data Loss Prevention (DLP): Prevent the exposure of sensitive information such as API keys and personal ID numbers.
Content Review: Check for prohibited words in requests and responses to prevent the spread of inappropriate content.
Access Control: Manage access permissions based on IP addresses, user identities, or rate limits.

4. Tracing Plugin

Use Jaeger for distributed tracing to help you understand the overall picture of the service call chain.
Automatically generate queryable tracing data for subsequent analysis and troubleshooting.

5. Cost Tracking

Record the cost of each MCP call (e.g., OpenAI API fees) and provide intuitive consumption trend charts to help optimize the budget.

6. Log Aggregation

Centralize the management of all MCP logs, support multiple log formats (JSON, text) and storage backends (local files, cloud services, etc.). A powerful search function facilitates quick problem - location.

7. Performance Monitoring

Monitor the response time, error rate, and throughput of each MCP, and set up alerts to detect abnormal situations in a timely manner.

8. Extension Plugins

Support the addition of custom modules to meet specific needs. Provide detailed documentation and examples to help developers quickly expand functionality.

📄 License

The MCP Gateway is licensed under the MIT License. The source code is publicly available, and users can freely modify and distribute it as needed.

This document comprehensively introduces how to optimize and manage the operating environment of multiple MCPs through the MCP Gateway, making it suitable for enterprises or developers who need to handle multi - MCP architectures.