CloudPulse MCP Server
CloudPulse MCP Server
Кросс-облачная видимость инфраструктуры для ИИ-агентов. Диагностируйте проблемы в AWS, Vercel, GCP и Cloudflare, не покидая редактор.
Почему CloudPulse?
Болевая точка | Решение CloudPulse |
Ошибка фронтенда на Vercel → нужно открывать консоль AWS |
|
ИИ не видит, блокирует ли SG порт 5432 |
|
Превышение лимитов параллелизма Lambda без уведомлений |
|
Топология неизвестна до отладки |
|
Быстрый старт
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 |
|
Vercel |
|
Vercel Team |
|
GCP |
|
Cloudflare |
|
Учетные данные не логируются и не сохраняются. Все значения считываются из переменных окружения во время вызова.
Доступные инструменты
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_regiondiagnose_service_link
Проверяет, почему сервис 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Добавление новой облачной платформы
Создайте
src/providers/<platform>/index.ts, экспортирующий:is<Platform>Configured(): booleanФункции данных, специфичные для провайдера
Подключите функции к соответствующим инструментам в
src/tools/Добавьте имя платформы в объединение
CloudPlatformвsrc/types.ts
Лицензия
MIT © Участники CloudPulse
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