Logfire MCP

🚀 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 跟踪和指标数据。

✨ 主要特性

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

📦 安装指南

启动 MCP 服务器的命令如下：

uvx logfire-mcp --read-token=YOUR_TOKEN

请将 YOUR_TOKEN 替换为您在 Logfire 控制台获取的访问令牌。

💻 使用示例

基础用法

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

find_exceptions

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

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

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
  }
]

arbitrary_query

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

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

示例问题

以下是一些使用 MCP 服务器工具可以解决的示例问题：

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

📚 详细文档

请参考 模型上下文协议服务器仓库 获取更多实现示例和开发模式。

📄 许可证

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

项目贡献

我们欢迎社区贡献，无论您是想添加新功能、修复问题还是改进文档，我们都欢迎您参与。