Skip to main content
Glama
Secure Agent MCP Gateway

Secure Agent MCP Gateway

by aki83reo

Secure Agent MCP Gateway

通过 MCP 到 MCP 的安全网关进行 SOC 告警分流:Agent 从不直接调用真实工具。每个 tools/list / tools/call 都会根据角色(viewer | operator | admin)进行范围限定和授权。

main.py (agent)  →  gateway  →  mcp_server (tools)

更多详情:gateway/README.md。

快速开始(本地)

python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

cp .env.example .env
# edit .env — set LLM_API_KEY (never commit .env)

三种角色服务(本地)

# 1) Viewer — reputation lookups only
python main.py --mcp --role viewer --alert sample_alert.json

# 2) Operator — triage / summarize / notify (no block or escalate)
python main.py --mcp --role operator --alert sample_alert.json

# 3) Admin — full tool set through the gateway
python main.py --mcp --role admin --alert sample_alert.json

确定性路径(无 MCP / 无网关):

python main.py --alert sample_alert.json

仅策略检查:

python -m gateway.policy

Related MCP server: production-mcp-server

Docker 部署

需要 Docker 与 Compose。密钥保留在镜像之外:

cp .env.example .env
# set LLM_API_KEY in .env

构建

docker compose build
# or:
docker build -t secure-agent-mcp-gateway:latest .

三个服务(每服务一个角色)

同一镜像,但 GATEWAY_ROLE 不同。每个容器为对应角色运行完整链路(main → gateway → mcp_server)。

# 1) Viewer
docker compose run --rm triage-viewer

# 2) Operator
docker compose run --rm triage-operator

# 3) Admin
docker compose run --rm triage-admin

或按服务名启动:

docker compose up triage-viewer
docker compose up triage-operator
docker compose up triage-admin

无需文件即可传入密钥:

LLM_API_KEY=sk-... docker compose run --rm triage-admin

纯 Docker(无 Compose)

docker build -t secure-agent-mcp-gateway:latest .

docker run --rm \
  -e LLM_API_KEY \
  -e LLM_MODEL=gpt-4o-mini \
  -e GATEWAY_ROLE=viewer \
  secure-agent-mcp-gateway:latest \
  python main.py --mcp --role viewer --alert sample_alert.json

docker run --rm -e LLM_API_KEY -e GATEWAY_ROLE=operator \
  secure-agent-mcp-gateway:latest \
  python main.py --mcp --role operator --alert sample_alert.json

docker run --rm -e LLM_API_KEY -e GATEWAY_ROLE=admin \
  secure-agent-mcp-gateway:latest \
  python main.py --mcp --role admin --alert sample_alert.json

环境变量

变量

用途

LLM_API_KEY

Agent 与发现摘要所需

LLM_MODEL

默认 gpt-4o-mini

LLM_PROVIDER

默认 openai

GATEWAY_ROLE

viewer | operator | admin

.env 已被 git 忽略。只有 .env.example 会被提交。

角色(策略)

角色

可使用的工具

viewer

check_ip_reputation

operator

信誉、分流、摘要、通知

admin

所有工具,包括 block_ip + escalate_alert

定义于 gateway/policy.yaml。

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

    • A
      license
      Not graded
      quality
      C
      maintenance
      A secure MCP gateway for enterprise AI tool execution, enabling governed invocation of business tools with authentication, RBAC, audit logging, PII redaction, and async processing.
      Apache 2.0
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to safely call enterprise tools through a governed MCP gateway with permission enforcement, blast-radius controls, input validation, and a full audit trail for every invocation.
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Provides a security governance layer for AI agents to safely access upstream MCP servers, enforcing tool-level RBAC, parameter constraints, authentication via static tokens or OIDC, and tamper-evident audit logging.
      2
      1
      Apache 2.0