AI导哈

日志查询工具

Papertrail MCP Agent for Cursor 是一个将Papertrail日志暴露给Cursor代理的工具，支持按时间范围、系统名称或ID以及日志组名称查询日志。

  • by MartinKlefas
  • Jupyter Notebook
  • 本地部署
  • 更新于
在 GitHub 查看 martinklefas/papertrail-mcp-server

使用说明

用于Cursor的Papertrail MCP代理

此MCP工具使用以下命令将Papertrail日志暴露给Cursor的代理 mcp.server.fastmcp 库以实现最大兼容性。

端点

1. /tools/get_logs_by_time

根据时间范围和可选的系统名称或ID获取日志。

有效载荷：

{
  "time_from": "1 hour ago",
  "time_to": "30 minutes ago",
  "system": "backend-server",
  "query": "error"
}

2. /tools/list_groups

列出Papertrail中可用的所有已保存日志组（已保存搜索）。

答复：

[
  { "id": 123, "name": "backend" },
  { "id": 456, "name": "frontend" }
]

3. /tools/logs_by_group_name

按组的可读名称从组中获取日志。这在内部将名称解析为组ID。

有效载荷：

{
  "group_name": "backend",
  "time_from": "1 hour ago",
  "query": "exception"
}

入门指南

  1. 克隆此仓库并创建虚拟环境:
cd papertrail-mcp-server
python -m venv .venv
.venv\Scripts\activate
  1. 安装依赖项:
pip install -r requirements.txt
  1. 设置您的Papertrail API令牌 （在环境变量中）：

您可以：

  • 将其添加到您的系统/用户环境变量中，或
  • 将此行添加到 .env 此处的文件用于在代码中加载：
# Add to .env
PAPERTRAIL_API_TOKEN = "your-token-here"
  1. 更新光标MCP配置:

在您的项目中 .cursor/mcp.json 调整路径以反映您克隆此仓库的位置。

以下是针对窗户的结构：

{
  "mcpServers": {
    "papertrail-logs": {
      "command": "**project path**\\**venv path**\\uv",
      "args": [
        "run",
        "--directory", "**project path**",
        "papertrail_agent.py"
      ]
    }
  }
}

以下内容适用于*nix系统：

{
  "mcpServers": {
    "papertrail-logs": {
      "command": "**project path**/**venv path**/uv",
      "args": [
        "run",
        "--directory", "**project path**",
        "papertrail_agent.py"
      ]
    }
  }
}

⚠️ 确保此文件位于您的 游标项目根 在...之下 .cursor/mcp.json.

  1. 新代理的保存和接受提示：

您应该在左下角看到一个提示以启用代理，您可能会被带到设置屏幕，它应该显示有4个可用工具：

  1. 在光标（代理模式）中使用：

问这样的问题：

“从 backend 组从1小时前到现在与关键字 error"

相关 MCP