Skip to main content
Glama

CloudPulse MCP Server

Кросс-облачная видимость инфраструктуры для ИИ-агентов. Диагностируйте проблемы в AWS, Vercel, GCP и Cloudflare, не покидая редактор.

License: MIT Node.js ≥18


Почему CloudPulse?

Болевая точка

Решение CloudPulse

Ошибка фронтенда на Vercel → нужно открывать консоль AWS

get_correlated_logs автоматически объединяет обе временные шкалы

ИИ не видит, блокирует ли SG порт 5432

diagnose_service_link проверяет правила группы безопасности в реальном времени

Превышение лимитов параллелизма Lambda без уведомлений

check_resource_limits предупреждает при достижении 80% использования

Топология неизвестна до отладки

list_cloud_topology отображает все активные сервисы за секунды


Быстрый старт

1. Установка / запуск через npx

npx cloudpulse-mcp

Сервер автоматически обнаруживает учетные данные, уже присутствующие на вашем компьютере (AWS CLI, переменные окружения и т. д.).

2. Настройка ИИ-клиента

Claude Desktop – добавьте в ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "cloudpulse": {
      "command": "npx",
      "args": ["-y", "cloudpulse-mcp"],
      "env": {
        "VERCEL_TOKEN": "<your-vercel-token>",
        "AWS_PROFILE": "default",
        "AWS_REGION": "us-east-1"
      }
    }
  }
}

Cursor – добавьте в .cursor/mcp.json в вашем проекте:

{
  "mcpServers": {
    "cloudpulse": {
      "command": "npx",
      "args": ["-y", "cloudpulse-mcp"],
      "env": {
        "VERCEL_TOKEN": "<your-vercel-token>",
        "AWS_REGION": "us-east-1"
      }
    }
  }
}

VS Code + GitHub Copilot (Agent Mode) – требуется VS Code 1.99+ и расширение GitHub Copilot.

Сначала соберите проект:

npm run build

Затем создайте .vscode/mcp.json в этом репозитории:

{
  "servers": {
    "cloudpulse": {
      "type": "stdio",
      "command": "node",
      "args": ["${workspaceFolder}/dist/index.js"],
      "env": {
        "VERCEL_TOKEN": "${env:VERCEL_TOKEN}",
        "AWS_REGION": "${env:AWS_REGION}",
        "AWS_PROFILE": "${env:AWS_PROFILE}"
      }
    }
  }
}

${env:VAR} считывается из переменных окружения вашей оболочки — никаких секретов в системе контроля версий.

Для использования: откройте Copilot Chat, переключитесь в Agent mode, нажмите Select Tools и включите инструменты CloudPulse, затем спросите естественным языком:

Why can't my Vercel project reach AWS RDS instance "my-db"?

Учетные данные и безопасность

CloudPulse придерживается политики только для чтения, без хранения:

Учетные данные

Как предоставить

AWS

AWS_ACCESS_KEY_ID + AWS_SECRET_ACCESS_KEY, или AWS_PROFILE, или роль инстанса EC2

Vercel

VERCEL_TOKEN (личный токен доступа с vercel.com/account/tokens)

Vercel Team

VERCEL_TEAM_ID (опционально)

GCP

GOOGLE_APPLICATION_CREDENTIALS

Cloudflare

CLOUDFLARE_API_TOKEN + CLOUDFLARE_ACCOUNT_ID

Учетные данные не логируются и не сохраняются. Все значения считываются из переменных окружения во время вызова.


Доступные инструменты

list_cloud_topology

Сканирует все настроенные платформы и возвращает единую карту сервисов.

Input (all optional):
  platforms       – ["aws", "vercel"]  filter platforms
  aws_region      – "us-east-1"

get_correlated_logs

Получает и объединяет логи из Vercel + AWS CloudWatch в одну временную шкалу.

Input:
  start_time *    – ISO-8601 or epoch ms  e.g. "2024-06-01T10:00:00Z"
  end_time        – defaults to now
  trace_id        – filter by trace/request ID across all sources
  aws_log_group_prefix  – default "/aws/lambda"
  vercel_project  – project name or ID
  aws_region

Проверяет, почему сервис A не может получить доступ к ресурсу B.

Input:
  source_service *  – "vercel" | "lambda" | "ec2" | ...
  target_resource * – "<type>:<id>"  e.g. "aws-rds:my-db", "external-api:https://..."
  port              – auto-detected (5432 for RDS, 443 for APIs, ...)
  vercel_project
  aws_region

Выполняемые проверки:

  • Переменные окружения Vercel содержат DATABASE_URL / DB_URL

  • Группа безопасности AWS разрешает входящий TCP-трафик на требуемом порту

  • Тест доступности внешнего API через HEAD-запрос

check_resource_limits

Запрашивает квоты и помечает ресурсы, приближающиеся к своим лимитам.

Input (all optional):
  platforms        – filter platforms
  warn_threshold   – usage % to warn at (default 80)
  aws_region

Дорожная карта

Фаза

Статус

Область применения

1 – MVP

✅ Готово

Vercel + AWS (Lambda, RDS, CloudWatch, Security Groups, S3)

2 – Расширение

✅ Готово

GCP Cloud Run + Cloud SQL + Logging; Cloudflare Workers + Pages; S3 CORS

3 – Интеллект

🔜

Готовые диагностические сценарии для CORS, 504 timeout, циклы холодного старта


Разработка

git clone https://github.com/Galadriel-Tech-Solutions/cloudpulse-mcp
cd cloudpulse-mcp
npm install
npm run dev        # run from source with tsx
npm run build      # compile to dist/

Структура проекта

src/
├── index.ts                     # MCP server + tool registration
├── types.ts                     # shared domain types
├── utils.ts                     # concurrency, formatting helpers
├── providers/
│   ├── aws/
│   │   ├── index.ts             # client factory + isAWSConfigured()
│   │   ├── cloudwatch.ts        # CloudWatch Logs
│   │   ├── lambda.ts            # Lambda function listing
│   │   ├── rds.ts               # RDS/Aurora instances & clusters
│   │   ├── ec2.ts               # Security Group inspection
│   │   ├── s3.ts                # S3 buckets + CORS checks
│   │   └── quotas.ts            # Service Quotas API
│   ├── gcp/
│   │   ├── index.ts             # isGCPConfigured() + resolveGCPProject()
│   │   ├── cloud-run.ts         # Cloud Run services
│   │   ├── cloud-sql.ts         # Cloud SQL instances (sqladmin v1beta4)
│   │   └── logging.ts           # Cloud Logging
│   ├── cloudflare/
│   │   └── index.ts             # Pages, Workers, Worker tail logs (WebSocket)
│   └── vercel/
│       └── index.ts             # Vercel REST API v9
└── tools/
    ├── list-cloud-topology.ts
    ├── get-correlated-logs.ts
    ├── diagnose-service-link.ts
    └── check-resource-limits.ts

Добавление новой облачной платформы

  1. Создайте src/providers/<platform>/index.ts, экспортирующий:

    • is<Platform>Configured(): boolean

    • Функции данных, специфичные для провайдера

  2. Подключите функции к соответствующим инструментам в src/tools/

  3. Добавьте имя платформы в объединение CloudPlatform в src/types.ts


Лицензия

MIT © Участники CloudPulse

Install Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - A tier

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Galadriel-Tech-Solutions/cloudpulse-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server