Allows querying New Relic logs and metrics using NRQL queries, providing access to transaction data, error analysis, and performance metrics from a New Relic account.
New Relic MCP Server
A simple 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.
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
Install
uv
package manager:
Create and setup project:
Create server file
newrelic_logs_server.py
with the provided code.Configure your environment variables:
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:
Usage
Example NRQL Queries
Basic Transaction Query:
Error Analysis:
Performance Analysis:
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
Testing with MCP Inspector
Test your server functionality using:
Common Issues
Authentication Errors:
Check if NEW_RELIC_API_KEY is set correctly
Verify API key has correct permissions
Ensure API key is valid
Query Errors:
Verify NRQL syntax
Check account ID in code matches your account
Ensure queried data exists in the time range
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
Set environment variables:
Run the server:
Code Structure
The server implements:
Single NRQL query tool
Configurable New Relic account ID
Comprehensive error handling
Detailed logging
Response formatting
Testing Changes
Modify code as needed
Test with MCP Inspector
Restart Claude Desktop to apply changes
Troubleshooting Guide
Server Not Starting:
Check Python version
Verify all dependencies are installed
Ensure virtual environment is activated
Query Not Working:
Check logs for detailed error messages
Verify NRQL syntax
Ensure data exists in queried time range
Claude Not Connecting:
Verify configuration file syntax
Check paths are absolute
Restart Claude Desktop
Contributing
Fork the repository
Create a feature branch
Submit a pull request
License
This project is licensed under the MIT License.
Support
If you encounter issues:
Check the logs
Review common issues section
Test with MCP Inspector
File an issue on GitHub
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
A Model Context Protocol server that enables Large Language Models like Claude to query New Relic logs and metrics using NRQL queries.
Related MCP Servers
- -securityFlicense-qualityA Model Context Protocol server that enables Large Language Models to access and interact with database connections, including viewing schemas and performing CRUD operations on connected databases.Last updated -
- -securityAlicense-qualityA Model Context Protocol server that enables Large Language Models like Claude to manage Linode cloud resources, including listing regions, creating, viewing, deleting, and rebooting Linode instances.Last updated -11MIT License
- -securityFlicense-qualityA Model Context Protocol server that enables large language models to interact directly with Couchbase databases through natural language, supporting operations like querying buckets, performing CRUD operations, and executing N1QL queries.Last updated -97
- -securityAlicense-qualityA Model Context Protocol server that enables large language models like Claude to perform comprehensive interactions with Firebase Firestore databases, supporting full CRUD operations, complex queries, and advanced features like transactions and TTL management.Last updated -34MIT License