Datadog

🚀 Datadog MCP Server

A Model Context Protocol (MCP) server for interacting with the Datadog API.

🚀 Quick Start

The Datadog MCP Server is designed to interact with the Datadog API, enabling users to access various Datadog features such as monitoring, dashboards, and metrics.

✨ Features

• Monitoring: Access monitoring data and configurations.
• Dashboards: Retrieve and view dashboard definitions.
• Metrics: Query available metrics and their metadata.
• Events: Search for and retrieve events within a time frame.
• Logs: Search logs with advanced filtering and sorting options.
• Incidents: Access incident management data.
• API Integration: Directly integrate with Datadog's v1 and v2 APIs.
• Comprehensive Error Handling: Display clear error messages for API and authentication issues.

📦 Installation

Via npm (Recommended)

npm install -g datadog-mcp-server

From Source Code

1. Clone this repository.
2. Install dependencies:

npm install

3. Build the project:

npm run build

📚 Documentation

Configuration

Create a configuration file (e.g., config.json) with the following content:

{
  "datadog": {
    "apiKey": "your_api_key",
    "appKey": "your_app_key",
    "site": "us" // or "eu" depending on your region
  }
}

Usage

Start the Server

npm start

Debugging

To enable debug mode:

DEBUG=datadog-mcp-server npm start

💻 Usage Examples

Retrieve Metrics

const mcp = new DatadogMCP('localhost:5000');

mcp.getMetrics({ query: 'avg:system.load.15m' })
  .then(console.log)
  .catch(console.error);

Troubleshooting

If you encounter a 403 Forbidden error, verify the following:

1. Whether the API key and application key are correct.
2. Whether the keys have the necessary permissions to access the resources.
3. Whether the account has the permissions to access the required data.

Debugging

If you encounter issues, check the MCP logs of Claude Desktop:

# 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

Common issues:

• 403 Forbidden: Authentication issues with the Datadog API key.
• Invalid API key or App key format: Ensure you use the full key string.
• Incorrect site configuration: Please confirm you are using the correct Datadog domain name.

📄 License

This project is licensed under the MIT license.