Протокол контекста модели Datadog (MCP) 🔍

значок кузнеца

Инструмент на основе Python для взаимодействия с API Datadog и извлечения данных мониторинга из вашей инфраструктуры. Этот MCP обеспечивает легкий доступ к состояниям мониторинга и журналам Kubernetes через простой интерфейс.

Возможности Datadog 🌟

Отслеживание состояния монитора : выборка и анализ определенных состояний монитора.
Анализ журналов Kubernetes : извлечение и форматирование журналов ошибок из кластеров Kubernetes

Related MCP server: MongoDB MCP Server

Предварительные условия 📋

Питон 3.11+
API Datadog и ключи приложений (с правильными разрешениями)
Доступ к сайту Datadog

Установка 🔧

Установка через Smithery

Чтобы установить Datadog для Claude Desktop автоматически через Smithery :

npx -y @smithery/cli install @didlawowo/mcp-collection --client claude

Необходимые пакеты:

datadog-api-client fastmcp loguru icecream python-dotenv uv

Настройка среды 🔑

Создайте файл .env с вашими учетными данными Datadog:

DD_API_KEY=your_api_key DD_APP_KEY=your_app_key

Настройка Claude Desktop для MCP 🖥️

Установить Клод Десктоп

# Assuming you're on macOS brew install claude-desktop # Or download from official website https://claude.ai/desktop

Настройте конфигурацию Datadog MCP:

# on mac is ~/Library/Application\ Support/Claude/claude_desktop_config.json # Add this to your claude config json ```json "Datadog-MCP-Server": { "command": "uv", "args": [ "run", "--with", "datadog-api-client", "--with", "fastmcp", "--with", "icecream", "--with", "loguru", "--with", "python-dotenv", "fastmcp", "run", "/your-path/mcp-collection/datadog/main.py" ], "env": { "DD_API_KEY": "xxxx", "DD_APP_KEY": "xxx" } },

Использование 💻

получить журналы

получить монитор

Архитектура 🏗

FastMCP Base : использует фреймворк FastMCP для управления инструментами
Модульная конструкция : отдельные функции для мониторов и журналов
Безопасность типов : полная поддержка ввода с подсказками типов Python
Абстракция API : обернутые вызовы API Datadog с обработкой ошибок

Я добавлю раздел о настройке MCP и Claude Desktop:

Введение в протокол контекста модели (MCP) 🤖

Что такое МКП?

Model Context Protocol (MCP) — это фреймворк, позволяющий моделям ИИ взаимодействовать с внешними инструментами и API стандартизированным образом. Он позволяет таким моделям, как Клод:

Доступ к внешним данным
Выполнять команды
Взаимодействие с API
Сохраняйте контекст во время разговоров

некоторые примеры MCP-серверов

https://github.com/punkpeye/awesome-mcp-servers?tab=readme-ov-file

Учебник по настройке MCP

https://medium.com/@pedro.aquino.se/how-to-use-mcp-tools-on-claude-desktop-app-and-automate-your-daily-tasks-1c38e22bc4b0

Как это работает - Доступные функции 🛠️

LLM использует предоставленную функцию для получения данных и их использования

1. Получить состояния монитора

get_monitor_states( name: str, # Monitor name to search timeframe: int = 1 # Hours to look back )

Пример:

response = get_monitor_states(name="traefik") # Sample Output { "id": "12345678", "name": "traefik", "status": "OK", "query": "avg(last_5m):avg:traefik.response_time{*} > 1000", "message": "Response time is too high", "type": "metric alert", "created": "2024-01-14T10:00:00Z", "modified": "2024-01-14T15:30:00Z" }

2. Получите логи Kubernetes

get_k8s_logs( cluster: str, # Kubernetes cluster name timeframe: int = 5, # Hours to look back namespace: str = None # Optional namespace filter )

Пример:

logs = get_k8s_logs( cluster="prod-cluster", timeframe=3, namespace="default" ) # Sample Output { "timestamp": "2024-01-14T22:00:00Z", "host": "worker-1", "service": "nginx-ingress", "pod_name": "nginx-ingress-controller-abc123", "namespace": "default", "container_name": "controller", "message": "Connection refused", "status": "error" }

# Install as MCP extension cd datadog task install-mcp

4. Проверка установки

В чате Клода на рабочем столе

проверьте соединение datadog в claude

установка Клода

5. Используйте инструменты Datadog MCP

Вопросы безопасности 🔒

Сохраните ключи API в .env
MCP работает в изолированной среде
Каждый инструмент имеет определенные разрешения.
Реализовано ограничение скорости

Устранение неполадок 🔧

Использование MCP-инспектора

# Launch MCP Inspector for debugging task run-mcp-inspector

Инспектор MCP обеспечивает:

Просмотр состояния сервера MCP в реальном времени
Журналы вызовов функций
Отслеживание ошибок
Мониторинг ответа API

Распространенные проблемы и решения

Ошибки аутентификации API
Error: (403) Forbidden
➡️ Проверьте DD_API_KEY и DD_APP_KEY в .env
Проблемы с подключением MCP
Error: Failed to connect to MCP server
➡️ Проверьте путь и содержимое claude_desktop_config.json
Монитор не найден
Error: No monitor found with name 'xxx'
➡️ Проверьте правильность написания имени монитора и чувствительность к регистру
Журналы можно найти здесь

альтернативный текст

Вношу свой вклад 🤝

Не стесняйтесь:

Открытые вопросы по ошибкам
Подавайте PR-заявки на улучшения
Добавить новые функции

Заметки 📝

Вызовы API выполняются на сайт Datadog EU.
Временной интервал по умолчанию составляет 1 час для состояний монитора.
Ограничения на размер страницы установлены для большинства случаев использования.

datadog