logfire-mcp

🚀 Logfire MCP 服务器

本仓库涵盖一个模型上下文协议 (MCP) 服务器，配备相关工具，可用于访问您发送至 Logfire 的 OpenTelemetry 跟踪和指标数据。

🚀 快速开始

1. 获取 Logfire 访问令牌：访问 Logfire 控制台，创建并获取访问令牌。
2. 启动 MCP 服务器：

uvx logfire-mcp --read-token=YOUR_TOKEN

3. 配置客户端：依据您所使用的工具（如 Cursor、Claude Desktop 或 Cline），参考对应的配置示例进行设置。
4. 开始使用：运用 MCP 服务器提供的工具，对您的 OpenTelemetry 跟踪和指标数据展开分析。

✨ 主要特性

Logfire MCP 服务器具备以下功能：

1. 分析跟踪数据：助力您识别并分类应用程序中的异常情况。
2. 查询指标：提供灵活的查询功能，协助您获取所需数据。
3. 集成工具：支持与多种开发环境和框架集成。

📦 安装指南

此部分可参考快速开始中的步骤，先获取 Logfire 访问令牌，再启动 MCP 服务器，最后配置客户端即可开始使用。

💻 使用示例

基础用法

以下是 MCP 服务器提供的主要工具及其使用说明：

1. find_exceptions
   • 描述：查找指定时间段内的所有异常情况。
   • 参数：
     • age (int): 时间范围，单位为分钟，默认值为 60。
   • 返回结果：

[
  {
    "filepath": string,
    "count": int
  }
]

2. find_exceptions_in_file
   • 描述：查找指定文件中的异常情况。
   • 参数：
     • filepath (string): 文件路径。
     • age (int): 时间范围，单位为分钟，默认值为 60。
   • 返回结果：

[
  {
    "created_at": string,
    "message": string,
    "exception_type": string,
    "exception_message": string,
    "function_name": string,
    "line_number": string,
    "attributes": object,
    "trace_id": string
  }
]

3. arbitrary_query
   • 描述：允许您自定义查询。
   • 参数：
     • query (string): SQL 查询语句。
     • age (int): 时间范围，单位为分钟，默认值为 60。
   • 返回结果：

[
  {
    "trace_id": string,
    "message": string,
    "created_at": string,
    "service_name": string
  }
]

高级用法

以下是一些示例问题，展示如何使用这些工具解决实际问题：

1. “过去一小时所有服务中发生了哪些异常？”
2. “请展示文件 'app/api.py' 中最近的错误及其上下文跟踪信息。”
3. “昨天每分钟发生了多少次错误？”
4. “按服务名称分类，最常见的异常类型有哪些？”
5. “获取 OpenTelemetry 跟踪和指标的架构信息”
6. “查找昨天所有错误并展示其上下文跟踪信息”

📚 详细文档

项目贡献

我们热忱欢迎社区贡献，无论您是想增添新功能、修复问题还是完善文档，都欢迎您参与。 请参考 模型上下文协议服务器仓库 获取更多实现示例和开发模式。

📄 许可证

Logfire MCP 服务器采用 MIT 许可证。这意味着您可在任何项目中自由使用、修改和分发该软件，但需遵循 MIT 许可证的条款。