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