{"_id":"@channel.io/datadog-mcp","name":"@channel.io/datadog-mcp","dist-tags":{"latest":"0.2.0"},"versions":{"0.2.0":{"name":"@channel.io/datadog-mcp","version":"0.2.0","description":"Datadog MCP - Model Context Protocol server for Datadog API","main":"dist/index.js","type":"module","bin":{"datadog-mcp":"dist/index.js"},"scripts":{"build":"tsc && shx chmod +x dist/index.js","dev":"tsc --watch","typecheck":"tsc --noEmit","lint":"eslint src/**/*.ts","lint:fix":"eslint src/**/*.ts --fix"},"dependencies":{"@datadog/datadog-api-client":"^1.34.0","@modelcontextprotocol/sdk":"^1.6.1","zod":"^3.22.4"},"devDependencies":{"@types/node":"^20.11.5","shx":"^0.3.4","typescript":"^5.3.3"},"engines":{"node":">=18.0.0"},"publishConfig":{"access":"public"},"gitHead":"fa7ac024df272b83d3cf14c0d98b7ff596117602","types":"./dist/index.d.ts","_id":"@channel.io/datadog-mcp@0.2.0","_nodeVersion":"24.12.0","_npmVersion":"11.6.2","dist":{"integrity":"sha512-gtvaz4WNRjRzOQRrvr9NSqnfAgsDkU1M4lAy8P2dLozIvSySbh/AaDIgdDs7SlURbzfPrbQMcZkRosZCyhzmkQ==","shasum":"4ab0f42ad6227abdba055a9ba4791d35f4e69ea2","tarball":"https://registry.npmjs.org/@channel.io/datadog-mcp/-/datadog-mcp-0.2.0.tgz","fileCount":6,"unpackedSize":79018,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIFWaNd9b59F0hSv7HCB4wLFrS094dPEqLTDjye/5lKsvAiAZ7TMHxUA+3Z5cOfuYxHmJMjOttU8ndX0nX1Td+cHmGQ=="}]},"_npmUser":{"name":"zoyi","email":"eng@channel.io"},"directories":{},"maintainers":[{"name":"polarshin","email":"polar@channel.io"},{"name":"zoyi","email":"eng@channel.io"},{"name":"quino0627","email":"dongwook627@gmail.com"},{"name":"sungik.dev","email":"sungik.dev@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/datadog-mcp_0.2.0_1771567849201_0.652493160635186"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-20T06:10:49.034Z","0.2.0":"2026-02-20T06:10:49.360Z","modified":"2026-02-20T06:10:49.637Z"},"maintainers":[{"name":"polarshin","email":"polar@channel.io"},{"name":"zoyi","email":"eng@channel.io"},{"name":"quino0627","email":"dongwook627@gmail.com"},{"name":"sungik.dev","email":"sungik.dev@gmail.com"}],"description":"Datadog MCP - Model Context Protocol server for Datadog API","readme":"# Datadog MCP\n\nDatadog API를 활용한 Model Context Protocol(MCP) 서버입니다. AI 어시스턴트가 Datadog의 로그, 메트릭, 모니터, APM 데이터에 접근할 수 있게 해줍니다.\n\n## 기능\n\n이 MCP 서버는 다음 도구들을 제공합니다:\n\n| 도구                           | 설명                                   |\n| ------------------------------ | -------------------------------------- |\n| `whoami`                       | API 키 유효성 검증                     |\n| `search_logs`                  | 로그 검색 (쿼리, 시간 범위 필터링)     |\n| `list_monitors`                | 모니터 목록 조회                       |\n| `get_monitor`                  | 특정 모니터 상세 조회                  |\n| `search_events`                | 이벤트 스트림 검색                     |\n| `query_metrics`                | 메트릭 데이터 쿼리                     |\n| `search_spans`                 | APM 스팬/트레이스 검색                 |\n| `get_trace_details`            | 특정 트레이스 ID로 전체 요청 흐름 조회 |\n| `search_error_tracking_issues` | 에러 트래킹 이슈 검색 (그룹화된 에러)  |\n| `list_rum_applications`        | RUM 애플리케이션 목록 조회             |\n| `search_rum_events`            | RUM 이벤트 검색 (요약)                 |\n| `get_rum_event_detail`         | RUM 이벤트 상세 조회                   |\n| `aggregate_rum_events`         | RUM 이벤트 집계/분석                   |\n\n## 설치 및 설정\n\n### 환경 변수\n\n다음 환경 변수가 필요합니다:\n\n| 변수         | 필수 | 설명                                     |\n| ------------ | ---- | ---------------------------------------- |\n| `DD_API_KEY` | ✅   | Datadog API 키                           |\n| `DD_APP_KEY` | ✅   | Datadog Application 키                   |\n| `DD_SITE`    | ❌   | Datadog 사이트 (기본값: `datadoghq.com`) |\n\n### Datadog 키 발급\n\n1. [Datadog 콘솔](https://app.datadoghq.com)에 로그인\n2. **Organization Settings** → **API Keys**에서 API 키 생성\n3. **Organization Settings** → **Application Keys**에서 Application 키 생성\n\n### Claude Desktop 설정\n\n`claude_desktop_config.json`에 다음을 추가하세요:\n\n```json\n{\n  \"mcpServers\": {\n    \"datadog\": {\n      \"command\": \"npx\",\n      \"args\": [\"@channel.io/datadog-mcp\"],\n      \"env\": {\n        \"DD_API_KEY\": \"your-api-key\",\n        \"DD_APP_KEY\": \"your-application-key\",\n        \"DD_SITE\": \"datadoghq.com\"\n      }\n    }\n  }\n}\n```\n\n### 사이트 설정\n\nDatadog 리전에 따라 `DD_SITE`를 설정하세요:\n\n| 리전       | DD_SITE             |\n| ---------- | ------------------- |\n| US1 (기본) | `datadoghq.com`     |\n| US3        | `us3.datadoghq.com` |\n| US5        | `us5.datadoghq.com` |\n| EU         | `datadoghq.eu`      |\n| AP1        | `ap1.datadoghq.com` |\n\n## 사용 예시\n\n### 로그 검색\n\n```\n\"최근 일주일간 payment 서비스의 에러 로그를 검색해줘\"\n```\n\nMCP 도구 호출:\n\n```json\n{\n  \"tool\": \"search_logs\",\n  \"arguments\": {\n    \"query\": \"service:payment status:error\",\n    \"from\": \"2026-01-22T00:00:00Z\",\n    \"to\": \"2026-01-29T23:59:59Z\",\n    \"limit\": 100\n  }\n}\n```\n\n### 메트릭 조회\n\n```\n\"지난 1시간 동안의 CPU 사용률을 조회해줘\"\n```\n\nMCP 도구 호출:\n\n```json\n{\n  \"tool\": \"query_metrics\",\n  \"arguments\": {\n    \"query\": \"avg:system.cpu.user{*}\",\n    \"from\": 1706500000,\n    \"to\": 1706503600\n  }\n}\n```\n\n### APM 트레이스 검색\n\n```\n\"응답 시간이 1초 이상인 API 요청들을 찾아줘\"\n```\n\nMCP 도구 호출:\n\n```json\n{\n  \"tool\": \"search_spans\",\n  \"arguments\": {\n    \"query\": \"service:api-gateway @duration:>1s\",\n    \"from\": \"2026-01-28T00:00:00Z\",\n    \"to\": \"2026-01-29T00:00:00Z\"\n  }\n}\n```\n\n### 특정 트레이스 상세 조회\n\n```\n\"이 트레이스 ID의 전체 요청 흐름을 보여줘: abc123def456\"\n```\n\nMCP 도구 호출:\n\n```json\n{\n  \"tool\": \"get_trace_details\",\n  \"arguments\": {\n    \"traceId\": \"abc123def456\",\n    \"from\": \"2026-01-28T00:00:00Z\",\n    \"to\": \"2026-01-29T00:00:00Z\"\n  }\n}\n```\n\n### 에러 트래킹 이슈 검색\n\n```\n\"최근 발생한 에러 이슈들을 보여줘\"\n```\n\nMCP 도구 호출:\n\n```json\n{\n  \"tool\": \"search_error_tracking_issues\",\n  \"arguments\": {\n    \"query\": \"*\",\n    \"from\": \"2026-01-22T00:00:00Z\",\n    \"to\": \"2026-01-29T23:59:59Z\",\n    \"limit\": 25\n  }\n}\n```\n\n### RUM 클라이언트 에러 검색\n\n```\n\"웹 앱에서 발생한 JavaScript 에러들을 찾아줘\"\n```\n\nMCP 도구 호출:\n\n```json\n{\n  \"tool\": \"search_rum_events\",\n  \"arguments\": {\n    \"query\": \"@type:error service:my-web-app\",\n    \"from\": \"2026-01-28T00:00:00Z\",\n    \"to\": \"2026-01-29T00:00:00Z\",\n    \"limit\": 50\n  }\n}\n```\n\n### RUM 페이지 로딩 성능 분석\n\n```\n\"로딩 시간이 3초 이상인 페이지들을 찾아줘\"\n```\n\nMCP 도구 호출:\n\n```json\n{\n  \"tool\": \"search_rum_events\",\n  \"arguments\": {\n    \"query\": \"@type:view @view.loading_time:>3000000000\",\n    \"from\": \"2026-01-28T00:00:00Z\",\n    \"to\": \"2026-01-29T00:00:00Z\"\n  }\n}\n```\n\n### RUM 성능 메트릭 집계\n\n```\n\"페이지별 평균 로딩 시간을 알려줘\"\n```\n\nMCP 도구 호출:\n\n```json\n{\n  \"tool\": \"aggregate_rum_events\",\n  \"arguments\": {\n    \"query\": \"@type:view\",\n    \"from\": \"2026-01-28T00:00:00Z\",\n    \"to\": \"2026-01-29T00:00:00Z\",\n    \"metric\": \"avg\",\n    \"metricField\": \"@view.loading_time\",\n    \"groupBy\": \"@view.name\"\n  }\n}\n```\n\n## 개발\n\n```bash\n# 의존성 설치\npnpm install\n\n# 빌드\npnpm build\n\n# 개발 모드 (watch)\npnpm dev\n\n# 타입 체크\npnpm typecheck\n```\n\n## 라이선스\n\nChannel 내부용\n","readmeFilename":"README.md","_rev":"1-6c7bbe23ae9f39451ee5b3cb7db9daea"}