用于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"
}______________________________________________________________________
入门指南
- 克隆此仓库并创建虚拟环境:
cd papertrail-mcp-server
python -m venv .venv
.venv\Scripts\activate- 安装依赖项:
pip install -r requirements.txt- 设置您的Papertrail API令牌 （在环境变量中）：
您可以：
- 将其添加到您的系统/用户环境变量中，或
- 将此行添加到
.env此处的文件用于在代码中加载：
# Add to .env
PAPERTRAIL_API_TOKEN = "your-token-here"- 更新光标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.
- 新代理的保存和接受提示：
您应该在左下角看到一个提示以启用代理，您可能会被带到设置屏幕，它应该显示有4个可用工具：
Settings screen showing enabled tool
- 在光标（代理模式）中使用：
问这样的问题：
“从backend组从1小时前到现在与关键字error"