Skip to main content
Glama
deenesjakoruzh
patelketul1230

Enterprise Secure AWS MCP Server

by patelketul1230
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

Корпоративный защищённый сервер AWS Model Context Protocol (MCP)

Сервер Model Context Protocol (MCP) промышленного уровня, развёрнутый на AWS Lambda и API Gateway, со 100% Terraform IaC, zero-trust IAM RBAC и защитными механизмами OWASP LLM Top 10.

Обзор архитектуры AWS

Диаграмма архитектуры AWS Enterprise MCP Server в Figma

Related MCP server: MCP Airlock

Возможности

  • Стандартные спецификации MCP: Полная поддержка обнаружения инструментов Anthropic Model Context Protocol (MCP) (/mcp/tools) и выполнения инструментов (/mcp/tools/call).

  • IAM Role-Based Access Control (RBAC): Ограничивает выполнение инструментов по ролям (sre_read_only, security_auditor, sre_admin).

  • Защита OWASP LLM02: Пограничная санитизация, блокирующая инъекции через метасимволы подоболочки ([;&|'$]).

  • Защита OWASP LLM06: Автоматический редактор выходного буфера, вычищающий ключи доступа AWS (AKIA...) и PII.

  • Интерактивный Web UI Playground: Тестовый интерфейс с тёмной темой, работающий на http://localhost:8080 (make ui).

  • Нулевая стоимость простоя в облаке: Разворачивается с помощью Terraform одной командой (make deploy) и мгновенно удаляется (make destroy).

Демонстрация Web UI Playground

Ниже представлена автоматизированная интерактивная демонстрация в высоком разрешении, показывающая отказ в доступе RBAC, защиту от инъекций команд и успешный перезапуск сервера под ролью sre_admin:

Демонстрация тестирования безопасности Web UI AWS MCP Server

Предварительные требования и настройка системы

Перед настройкой проекта убедитесь, что в вашем окружении установлены Python 3.11+, Terraform и AWS CLI.

1. Системные зависимости (Linux / Ubuntu / Debian)

sudo apt update && sudo apt install python3-venv python3-pip terraform awscli -y

2. Настройка окружения

Клонируйте репозиторий и установите зависимости проекта в изолированное виртуальное окружение (.venv):

git clone https://github.com/patelketul1230/aws-mcp-enterprise-server.git
cd aws-mcp-enterprise-server

# Create .venv and install dependencies
make install

Структура репозитория

aws-mcp-enterprise-server/
├── docs/
│   ├── assets/                    # Centralized PNG images & HD animations
│   │   ├── mcp_aws_figma_architecture_diagram.png
│   │   ├── mcp_ui_testing_demo.webp
│   │   ├── mcp_ui_testing_demo.gif
│   │   ├── mcp_ui_playground_success_screenshot.png
│   │   ├── mcp_ui_playground_admin_success_screenshot.png
│   │   └── mcp_ui_playground_blocked_screenshot.png
│   ├── blogs/                     # 3 Medium Sub-Blogs ready for publication
│   │   ├── blog_1_1_mcp_decoded.md
│   │   ├── blog_1_2_mcp_rbac_python.md
│   │   └── blog_1_3_mcp_tool_poisoning.md
│   ├── architecture.md            # Figma diagrams & sequence flows
│   ├── 5w_and_how.md              # 5 Ws + 1 H problem statement & threat model
│   └── demo_execution.log         # Verified test execution log
├── src/
│   ├── clients/                   # AWS Bedrock Converse API integration client
│   ├── middleware/                # MCPSecurityValidator (RBAC & DLP)
│   ├── tools/                     # CloudWatch & Terraform tool modules
│   ├── ui/                        # Interactive Web UI Playground (index.html)
│   └── server.py                  # AWS Lambda & FastAPI server handler
├── terraform/                     # 100% Terraform IaC (API Gateway, IAM, Lambda)
├── tests/                         # Pytest suite & live verification scripts
├── Makefile                       # Lifecycle hooks (make deploy / make destroy / make ui)
└── README.md                      # Project documentation

Краткое руководство по началу работы

1. Установка зависимостей

make install

2. Запуск тестов

make test

3. Развёртывание инфраструктуры в AWS

make deploy

Выходные данные:

  • API Endpoint: динамический вывод, генерируемый Terraform

  • CloudWatch Log Group: /aws/mcp/aws-mcp-enterprise-server-dev

4. Запуск интерактивного Web UI Playground

make ui

Откройте http://localhost:8080 в вашем веб-браузере, чтобы наглядно протестировать вызовы инструментов, роли RBAC и защиту от инъекций!

5. Тестирование через терминал (curl)

# Health Check
curl -s <YOUR_API_ENDPOINT>/health

# Tool Discovery Catalog
curl -s <YOUR_API_ENDPOINT>/mcp/tools

# Valid Tool Call (CloudWatch Query)
curl -s -X POST <YOUR_API_ENDPOINT>/mcp/tools/call \
  -H "Content-Type: application/json" \
  -H "X-User-Role: sre_read_only" \
  -d '{"tool_name": "query_cloudwatch_logs", "arguments": {"log_group": "/aws/lambda/payment-dev", "filter_pattern": "ERROR"}}'

# Command Injection Attack (Returns 403 Forbidden)
curl -s -X POST <YOUR_API_ENDPOINT>/mcp/tools/call \
  -H "Content-Type: application/json" \
  -H "X-User-Role: sre_read_only" \
  -d '{"tool_name": "query_cloudwatch_logs", "arguments": {"log_group": "/aws/lambda/payment-dev; rm -rf /", "filter_pattern": "ERROR"}}'

6. Удаление ресурсов AWS

make destroy

Ссылки на техническую документацию

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • MCP2Lambda

    danilop
    A
    license
    B
    quality
    D
    maintenance
    Enables AI models to interact with AWS Lambda functions via the MCP protocol, allowing access to private resources, real-time data, and custom computation in a secure environment.
    2
    109
    MIT

  • MCP Airlock

    lara-muhanna
    A
    license
    C
    quality
    D
    maintenance
    Enables secure, zero-trust access to MCP tools through short-lived, signed capability leases that bind tool execution to specific sessions, intents, and constraints. Prevents prompt injection attacks and privilege escalation with dynamic risk scoring, policy enforcement, and tamper-evident audit logging.
    4
    1
    MIT

  • AWS Lambda Tool MCP Server

    tushar3006
    A
    license
    Not graded
    quality
    D
    maintenance
    Bridges MCP clients and AWS Lambda functions, enabling generative AI models to invoke Lambda functions as tools without code changes.
    Apache 2.0