Skip to main content
Glama
mcp-gateway

mcp-gateway

by wxsh-hub

MCP Gateway

MCP 생태계의 보안 미들웨어 — LLM과 도구 서버 사이에 보호 장벽 구축

License: MIT Python 3.10+

어떤 문제를 해결하나요?

LLM Agent가 MCP 프로토콜을 통해 외부 도구를 호출할 때 세 가지 핵심 위험이 있습니다:

  1. 자격 증명 유출 — 도구 응답에 API Key, Token 등 민감 정보가 포함되어 LLM 컨텍스트에 직접 노출될 수 있음

  2. 개인정보 외부 유출 — 사용자 개인 정보(이름, 주민등록번호, 카드 번호)가 도구 호출 체인에서 전달될 수 있음

  3. 악성 도구 주입 — 도구 설명에 prompt injection 명령이 숨겨져 Agent가 위험한 작업을 수행하도록 유도할 수 있음

MCP Gateway는 프록시 계층으로 모든 트래픽을 가로채 요청/응답이 Agent에 도달하기 전에 보안 필터링을 수행합니다.

Related MCP server: @guardbee/mcp-security-proxy

아키텍처 개요

┌─────────────┐      ┌──────────────────────────────────┐      ┌─────────────┐
│             │      │          MCP Gateway             │      │             │
│   LLM Agent │ ───► │  ┌──────────┐  ┌──────────────┐  │ ───► │  MCP Server │
│             │      │  │ Sanitize │  │   Plugin     │  │      │  (tools)    │
│             │ ◄─── │  │ Request  │  │   Pipeline   │  │ ◄─── │             │
└─────────────┘      │  └──────────┘  └──────────────┘  │      └─────────────┘
                     │         ▲               │         │
                     │         │    ┌──────────▼──┐      │
                     │         │    │  Sanitize   │      │
                     │         │    │  Response   │      │
                     │         │    └─────────────┘      │
                     └──────────────────────────────────┘

핵심 흐름:

  • 요청 방향: Plugin Pipeline이 매개변수를 비식별화(예: PII 제거, 주입 명령 필터링)

  • 응답 방향: 도구 반환 값에 대해 Token 마스킹, 민감 정보 필터링 수행

  • 시작 단계: Security Scanner가 구성된 모든 MCP Server에 대한 평판 평가 수행

빠른 시작

설치

git clone <your-repo-url>
cd mcp-gateway
pip install -e .

선택적 의존성:

pip install -e .[presidio]   # 启用 PII 检测(基于 Microsoft Presidio)

최소 구성

프로젝트 루트에 mcp.json 생성:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "."]
    }
  }
}

시작

# 启用基础 Token 掩码
mcp-gateway -p basic

# 启用 Token 掩码 + PII 检测
mcp-gateway -p basic -p presidio

# 调试模式
LOGLEVEL=DEBUG mcp-gateway -p basic

Cursor / Claude Desktop에 통합

{
  "mcpServers": {
    "mcp-gateway": {
      "command": "mcp-gateway",
      "args": [
        "--mcp-json-path", "~/.cursor/mcp.json",
        "-p", "basic",
        "-p", "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-config>",
        "-p", "basic"
      ],
      "servers": {
        "filesystem": {
          "command": "npx",
          "args": ["-y", "@modelcontextprotocol/server-filesystem", "."]
        }
      }
    }
  }
}

보안 보호 기능

Token 마스킹 (basic 플러그인)

응답의 민감한 자격 증명을 자동으로 식별하고 대체하며, 12가지 주요 클라우드 플랫폼 및 개발 도구의 키 형식을 지원합니다:

유형

예시 형식

AWS Access Key

AKIA...

GitHub Token

ghp_..., gho_...

Azure Client Secret

*.azure.com 관련

GCP API Key

AIza...

JWT Token

eyJ...

HuggingFace Token

hf_...

GitLab Session Cookie

_gitlab_session=...

Slack App Token

xapp-...

Microsoft Teams Webhook

*.webhook.office.com

mcp-gateway -p basic

PII 감지 (presidio 플러그인)

Microsoft Presidio 엔진 기반으로 텍스트의 개인 식별 정보를 자동으로 식별하고 익명화합니다:

  • 신용카드 번호, IP 주소, 이메일

  • 전화번호, 주민등록번호(SSN)

  • 더 많은 엔티티 유형은 Presidio 문서 참조

pip install -e .[presidio]
mcp-gateway -p presidio

보안 스캐너 (--scan)

시작 전에 모든 MCP Server에 대한 평판 평가 및 도구 설명 분석 수행:

mcp-gateway --scan -p basic

스캔 차원:

  • 평판 평가 — GitHub 데이터(Star, Fork, Issue 활성도)와 NPM 다운로드 수 기반 종합 점수 계산

  • 도구 설명 스캔 — 숨겨진 prompt injection 명령, 민감한 파일 경로 참조, 위험한 작업 명령 감지

  • 자동 차단 — 평판 점수가 임계값(기본 30점) 미만인 Server는 blocked로 표시되어 로드가 차단됨

스캔 결과는 구성 파일에 기록됩니다:

{
  "servers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "."],
      "blocked": "passed"
    }
  }
}

상태 값: "passed" (안전) | "blocked" (차단) | "skipped" (수동 건너뜀) | null (미스캔)

호출 추적

Xetrack 추적 플러그인

모든 도구 호출의 전체 컨텍스트를 기록하며 SQLite 및 DuckDB 쿼리를 지원합니다:

pip install xetrack
mcp-gateway -p xetrack

환경 변수 구성:

  • XETRACK_DB_PATH — SQLite 데이터베이스 경로

  • XETRACK_LOGS_PATH — 로그 파일 디렉터리

{
  "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/"
      }
    }
  }
}

쿼리 예시:

from xetrack import Reader
df = Reader("tracing.db").to_df()
-- DuckDB
INSTALL sqlite; LOAD sqlite; ATTACH 'tracing.db' (TYPE sqlite);
SELECT server_name, capability_name, content_text FROM db.events LIMIT 10;

프록시 도구

Gateway는 LLM에 두 가지 표준화된 도구를 노출합니다:

도구

기능

get_metadata

등록된 모든 MCP Server의 기능 목록을 가져와 LLM이 적절한 도구를 선택하도록 지원

run_tool

Gateway를 통해 임의의 MCP 도구 호출을 실행하며 요청/응답 보안 처리를 자동 수행

플러그인 개발

플러그인 시스템은 ABC 기본 클래스 + 데코레이터 등록 패턴을 기반으로 합니다:

from mcp_gateway.plugins.base import GuardrailPlugin
from mcp_gateway.plugins.manager import register_plugin

@register_plugin
class MyPlugin(GuardrailPlugin):
    @property
    def name(self) -> str:
        return "my-plugin"

    def process_request(self, context):
        # 请求方向的处理逻辑
        return context.arguments

    def process_response(self, context, response):
        # 响应方向的处理逻辑
        return response

플러그인은 PluginManager를 통해 자동으로 발견 및 로드되며 요청/응답 양방향 인터셉트를 지원합니다.

프로젝트 구조

mcp_gateway/
├── __init__.py              # 包入口
├── server.py                # MCP Server 生命周期管理
├── gateway.py               # 动态工具注册、CLI 参数解析
├── config.py                # 配置文件加载
├── sanitizers.py            # 请求/响应安全分发
├── plugins/
│   ├── base.py              # Plugin ABC 基类
│   ├── manager.py           # 插件发现、注册、Pipeline
│   ├── guardrails/
│   │   ├── basic.py         # Token 掩码插件
│   │   └── presidio.py      # PII 检测插件
│   └── tracing/
│       └── xetrack.py       # 调用追踪插件
├── security_scanner/
│   ├── scanner.py           # 扫描器主入口
│   ├── github_collector.py  # GitHub API 数据采集
│   ├── npm_collector.py     # NPM Registry 数据采集
│   ├── smithery_collector.py# Smithery 市场数据采集
│   ├── project_analyzer.py  # 综合信誉评分算法
│   └── tool_poisoning_analyzer.py  # 工具描述安全分析
└── tests/
    ├── test_sanitizers.py
    ├── test_tool_poisoning_analyzer.py
    ├── test_plugin_pipeline.py
    └── test_config.py

License

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables safe use of any MCP server by proxying and live-scanning all tool requests and responses, blocking or redacting poison descriptions, indirect prompt injection, malicious arguments, and unauthorized destinations.
      -
    • A
      license
      Not graded
      quality
      F
      maintenance
      Enables transparent security for any MCP server by intercepting tool calls, blocking prompt injection attempts, masking PII in responses, and writing immutable audit logs.
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enforces MCP security by proxying between AI agents and MCP servers, scanning tools and results for prompt injection, enforcing allow/deny policies, redacting sensitive arguments, and logging all traffic.
      56 PyPI
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables secure, low-latency proxying of MCP tool calls by detecting and blocking malicious requests such as path traversals and command injections, while redacting leaked credentials.
      MIT