New Relic MCP Server

A Model Context Protocol (MCP) server for querying New Relic logs using NRQL queries. This server enables Large Language Models (LLMs) like Claude to interact with your New Relic data.

> Claude Code users: Also available as an installable plugin with slash commands, skills, and an investigation agent — no MCP server needed.

> Install with: `/plugin marketplace add Ivlad003/plugins` then `/plugin install newrelic-observability@ivlad-plugins`

> See Ivlad003/plugins for details.

Features

• Query New Relic logs and metrics using NRQL
• Detailed error logging
• Easy integration with Claude Desktop
• Human-readable output formatting
• Configurable New Relic account ID

Setup Instructions

Prerequisites

• Python 3.10 or higher
• New Relic account and API key
• Claude Desktop application

Installation Steps

1. Install `uv` package manager:

# On macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# On Windows (PowerShell)
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

2. Create and setup project:

# Create directory
mkdir newrelic-mcp
cd newrelic-mcp

# Create virtual environment
uv venv

# Activate virtual environment
source .venv/bin/activate  # On Unix/macOS
.venv\Scripts\activate     # On Windows

# Install dependencies
uv pip install "mcp[cli]" httpx

3. Create server file `newrelic_logs_server.py` with the provided code.

4. Configure your environment variables:

# On Unix/macOS
export NEW_RELIC_API_KEY="your-api-key-here"
export NEW_RELIC_ACCOUNT_ID="your-account-id-here"

# On Windows (CMD)
set NEW_RELIC_API_KEY=your-api-key-here
set NEW_RELIC_ACCOUNT_ID=your-account-id-here

# On Windows (PowerShell)
$env:NEW_RELIC_API_KEY = "your-api-key-here"
$env:NEW_RELIC_ACCOUNT_ID = "your-account-id-here"

Claude Desktop Integration

Configure Claude Desktop by editing your configuration file:

• macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
• Windows: `%APPDATA%\Claude\claude_desktop_config.json`

Add the following configuration:

{
    "mcpServers": {
        "newrelic": {
            "command": "uv",
            "args": [
                "--directory",
                "/absolute/path/to/newrelic-mcp",
                "run",
                "app.py"
            ],
            "env": {
                "NEW_RELIC_API_KEY": "your-api-key-here",
                "NEW_RELIC_ACCOUNT_ID": "your-account-id-here"
            }
        }
    }
}

Usage

Example NRQL Queries

1. Basic Transaction Query:

SELECT * FROM Transaction SINCE 1 hour ago

2. Error Analysis:

SELECT * FROM Transaction WHERE error IS TRUE SINCE 1 hour ago LIMIT 10

3. Performance Analysis:

SELECT average(duration) FROM Transaction FACET name ORDER BY average(duration) DESC LIMIT 5

Example Claude Prompts

You can ask Claude questions like:

• "Show me all transactions from the last hour"
• "Are there any errors in our application?"
• "What are our slowest endpoints?"

Debugging

Viewing Logs

# On macOS/Linux
tail -f ~/Library/Logs/Claude/mcp-server-newrelic.log

# On Windows
type %APPDATA%\Claude\logs\mcp-server-newrelic.log

Testing with MCP Inspector

Test your server functionality using:

npx @modelcontextprotocol/inspector uv run newrelic_logs_server.py

Common Issues

1. Authentication Errors:

• Check if NEW_RELIC_API_KEY is set correctly
• Verify API key has correct permissions
• Ensure API key is valid

2. Query Errors:

• Verify NRQL syntax
• Check account ID in code matches your account
• Ensure queried data exists in the time range

3. Connection Issues:

• Check network connectivity
• Verify GraphQL endpoint is accessible
• Ensure no firewalls are blocking connections

Security Notes

• Never commit API keys to version control
• Use environment variables for sensitive data
• Keep dependencies updated
• Monitor query patterns and access logs

Development

Local Testing

1. Set environment variables:

export NEW_RELIC_API_KEY="your-api-key-here"
export NEW_RELIC_ACCOUNT_ID="your-account-id-here"

2. Run the server:

uv run newrelic_logs_server.py

Code Structure

The server implements:

• Single NRQL query tool
• Configurable New Relic account ID
• Comprehensive error handling
• Detailed logging
• Response formatting

Testing Changes

1. Modify code as needed

2. Test with MCP Inspector

3. Restart Claude Desktop to apply changes

Troubleshooting Guide

1. Server Not Starting:

• Check Python version
• Verify all dependencies are installed
• Ensure virtual environment is activated

2. Query Not Working:

• Check logs for detailed error messages
• Verify NRQL syntax
• Ensure data exists in queried time range

3. Claude Not Connecting:

• Verify configuration file syntax
• Check paths are absolute
• Restart Claude Desktop

Contributing

1. Fork the repository

2. Create a feature branch

3. Submit a pull request

License

This project is licensed under the MIT License.

Support

If you encounter issues:

1. Check the logs

2. Review common issues section

3. Test with MCP Inspector

4. File an issue on GitHub