MIT License
Datadog MCP 服务器
用于与 Datadog API 交互的模型上下文协议 (MCP) 服务器。
特征
监控：访问监控数据和配置
仪表板：检索和查看仪表板定义
指标：查询可用指标及其元数据
事件：在时间范围内搜索和检索事件
日志：使用高级过滤和排序选项搜索日志
事件：访问事件管理数据
API 集成：与 Datadog 的 v1 和 v2 API 直接集成
全面的错误处理：清晰的 API 和身份验证问题错误消息
服务特定端点：支持日志和指标的不同端点
先决条件
Node.js（版本 16 或更高版本）
Datadog 帐户：
API 密钥 - 在“组织设置”>“API 密钥”中找到
应用程序密钥 - 在“组织设置”>“应用程序密钥”中找到
安装
通过 npm（推荐）
npm install -g datadog-mcp-server
来自源
克隆此存储库
安装依赖项：
npm install构建项目：
npm run build
配置
您可以使用环境变量或命令行参数配置 Datadog MCP 服务器。
环境变量
使用您的 Datadog 凭证创建一个.env文件：
DD_API_KEY=your_api_key_here
DD_APP_KEY=your_app_key_here
DD_SITE=datadoghq.com
DD_LOGS_SITE=datadoghq.com
DD_METRICS_SITE=datadoghq.com
注意： DD_LOGS_SITE和DD_METRICS_SITE是可选的，如果未指定，则默认为DD_SITE的值。
命令行参数
全局站点设置的基本用法：
datadog-mcp-server --apiKey=your_api_key --appKey=your_app_key --site=datadoghq.eu
服务特定端点的高级用法：
datadog-mcp-server --apiKey=your_api_key --appKey=your_app_key --site=datadoghq.com --logsSite=logs.datadoghq.com --metricsSite=metrics.datadoghq.com
注意：站点参数不需要https:// - 它会自动添加。
区域端点
不同的 Datadog 区域有不同的端点：
美国（默认）：
datadoghq.com欧盟：
datadoghq.euUS3（政府云）：
ddog-gov.comUS5：
us5.datadoghq.comAP1：
ap1.datadoghq.com
与 Claude Desktop 一起使用
将其添加到您的claude_desktop_config.json中：
{
"mcpServers": {
"datadog": {
"command": "npx",
"args": [
"datadog-mcp-server",
"--apiKey",
"<YOUR_API_KEY>",
"--appKey",
"<YOUR_APP_KEY>",
"--site",
"<YOUR_DD_SITE>(e.g us5.datadoghq.com)"
]
}
}
}
对于具有用于日志和指标的单独端点的更高级配置：
{
"mcpServers": {
"datadog": {
"command": "npx",
"args": [
"datadog-mcp-server",
"--apiKey",
"<YOUR_API_KEY>",
"--appKey",
"<YOUR_APP_KEY>",
"--site",
"<YOUR_DD_SITE>",
"--logsSite",
"<YOUR_LOGS_SITE>",
"--metricsSite",
"<YOUR_METRICS_SITE>"
]
}
}
}
Claude 桌面配置文件的位置：
MacOS：
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows：
%APPDATA%/Claude/claude_desktop_config.json
与 MCP Inspector 一起使用
要与 MCP Inspector 工具一起使用：
npx @modelcontextprotocol/inspector datadog-mcp-server --apiKey=your_api_key --appKey=your_app_key
可用工具
该服务器提供以下 MCP 工具：
get-monitors ：获取带有可选过滤的监视器
get-monitor ：通过 ID 获取特定监视器的详细信息
get-dashboards ：列出所有仪表板
get-dashboard ：通过 ID 获取特定仪表板
get-metrics ：列出可用指标
get-metric-metadata ：获取特定指标的元数据
get-events ：获取时间范围内的事件
get-incidents ：列出带有可选过滤的事件
search-logs ：使用高级查询过滤搜索日志
聚合日志：对日志数据进行分析和聚合
示例
示例：获取监视器
{
"method": "tools/call",
"params": {
"name": "get-monitors",
"arguments": {
"groupStates": ["alert", "warn"],
"limit": 5
}
}
}
示例：获取仪表板
{
"method": "tools/call",
"params": {
"name": "get-dashboard",
"arguments": {
"dashboardId": "abc-def-123"
}
}
}
示例：搜索日志
{
"method": "tools/call",
"params": {
"name": "search-logs",
"arguments": {
"filter": {
"query": "service:web-app status:error",
"from": "now-15m",
"to": "now"
},
"sort": "-timestamp",
"limit": 20
}
}
}
示例：聚合日志
{
"method": "tools/call",
"params": {
"name": "aggregate-logs",
"arguments": {
"filter": {
"query": "service:web-app",
"from": "now-1h",
"to": "now"
},
"compute": [
{
"aggregation": "count"
}
],
"groupBy": [
{
"facet": "status",
"limit": 10,
"sort": {
"aggregation": "count",
"order": "desc"
}
}
]
}
}
}
示例：获取事件
{
"method": "tools/call",
"params": {
"name": "get-incidents",
"arguments": {
"includeArchived": false,
"query": "state:active",
"pageSize": 10
}
}
}
故障排除
如果遇到 403 Forbidden 错误，请验证：
您的 API 密钥和应用程序密钥正确
这些密钥具有访问所请求资源的必要权限
您的帐户有权访问所请求的数据
您正在使用适合您所在地区的正确端点（例如，欧盟客户使用
datadoghq.eu）
调试
如果遇到问题，请检查 Claude Desktop 的 MCP 日志：
# On macOS
tail -n 20 -f ~/Library/Logs/Claude/mcp*.log
# On Windows
Get-Content -Path "$env:APPDATA\Claude\Logs\mcp*.log" -Tail 20 -Wait
常见问题：
403 禁止：Datadog API 密钥的身份验证问题
API 密钥或应用密钥格式无效：请确保您使用的是完整的密钥字符串
站点配置错误：确保您使用的是正确的 Datadog 域
端点不匹配：如果您对日志和指标使用单独的域，请验证特定于服务的端点是否正确设置
执照
麻省理工学院
Related MCP Servers
- -security-license-qualitySatellite Tracking MCP ServerLast updated -1MIT License
- Mozilla Public License 2.0