nr-mcp: New Relic MCP 服务器

MCP 服务器，允许 AI 代理查询 New Relic 以进行事件调试。

• 用户指南：如何将 nr-mcp 与您的 AI 助手一起使用
• 开发者指南：如何为 nr-mcp 做出贡献

---

用户指南

本节面向希望将 nr-mcp 服务器与 AI 助手一起使用的用户。

前提条件

• 具有以下信息的 New Relic 帐户：
  • API 密钥
  • 帐户 ID
  • 区域（美国或欧盟）

快速开始

选项 1：使用 Docker（推荐）

# 运行 Docker 容器，并设置所需的环境变量
docker run -it --rm \
  -e NEW_RELIC_API_KEY=your_api_key \
  -e NEW_RELIC_ACCOUNT_ID=your_account_id \
  -e NEW_RELIC_REGION=US \
  danielng123/nr-mcp

选项 2：使用 npx

暂不支持

MCP 客户端配置

要将 AI 助手连接到 nr-mcp，请将以下配置添加到您的 MCP 客户端设置：

Docker 连接

{
  "mcpServers": {
    "newrelic": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "NEW_RELIC_API_KEY",
        "-e",
        "NEW_RELIC_ACCOUNT_ID",
        "-e",
        "NEW_RELIC_REGION",
        "danielng123/nr-mcp"
      ],
      "env": {
        "NEW_RELIC_API_KEY": "<YOUR_API_KEY>",
        "NEW_RELIC_ACCOUNT_ID": "<YOUR_ACCOUNT_ID>",
        "NEW_RELIC_REGION": "US"
      }
    }
  }
}

本地安装连接

{
  "mcpServers": {
    "newrelic": {
      "command": "nr-mcp",
      "args": [],
      "env": {
        "NEW_RELIC_API_KEY": "<YOUR_API_KEY>",
        "NEW_RELIC_ACCOUNT_ID": "<YOUR_ACCOUNT_ID>",
        "NEW_RELIC_REGION": "US"
      }
    }
  }
}

与 AI 助手一起使用

将 nr-mcp 与 Claude Opus 或 GPT-4o 等 AI 助手一起使用时，请在您的提示中包含以下内容：

我需要分析我的应用程序的 New Relic 数据。
请使用 nr-mcp 服务器来：
1. 运行 NRQL 查询
2. 获取仪表板数据
3. 分析日志
4. [您的具体任务]

示例 NRQL 查询：SELECT count(*) FROM Transaction SINCE 1 hour ago

---

开发者指南

本节面向希望为 nr-mcp 项目做出贡献的开发者。

开发环境设置

# 克隆仓库
git clone https://github.com/ducduyn31/nr-mcp.git
cd nr-mcp

# 安装依赖
pnpm install

# 构建项目
pnpm build

Docker 开发

构建 Docker 镜像

# 在本地构建 Docker 镜像
docker build -t nr-mcp .

# 使用特定标签构建
docker build -t nr-mcp:1.6.0 .

运行 Docker 容器进行开发

# 运行并设置环境变量以进行开发
docker run -it --rm \
  -e NEW_RELIC_API_KEY=your_api_key \
  -e NEW_RELIC_ACCOUNT_ID=your_account_id \
  -e NEW_RELIC_REGION=US \
  nr-mcp

MCP Inspector 是一个强大的工具，用于调试和测试 MCP 服务器和客户端。 我们添加了一个简化的开发工作流程，可以自动监视文件更改、重建项目并运行 inspector：

# 启动开发工作流程
pnpm dev

此命令：

1. 监视 src 目录中 .ts 文件的更改
2. 检测到更改时自动重建项目
3. 并行运行 MCP Inspector

手动测试

您也可以单独运行这些命令：

# 监视文件更改并重建
pnpm watch

# 启动 inspector
pnpm inspector

使用 Inspector

Inspector 运行后：

1. 打开 Web 界面（通常位于 http://localhost:5173）
2. 选择“连接到服务器”
3. 选择“Stdio”作为传输类型
4. 输入启动服务器的命令：node dist/index.js
5. 点击“连接”

连接后，您可以：

• 浏览可用的工具
• 使用自定义参数进行测试调用
• 查看响应和任何错误
• 记录和重放测试会话

调试技巧

• 使用 inspector 比较预期响应与实际响应
• 监控每个工具调用的完整请求/响应周期
• 通过故意发送无效输入来检查是否正确处理错误
• 验证您的工具是否符合其声明的模式

开发

# 创建新工具
pnpm create-tool

# 代码检查
pnpm lint

# 格式化代码
pnpm format

许可证

MIT