Logfire MCP Server

基本能力

产品定位

Logfire MCP Server 是一个用于分析和查询 OpenTelemetry 追踪和指标数据的工具，旨在帮助开发者和 LLMs 更好地理解和调试应用程序的性能问题。

核心功能

1. 异常查找：
2. find_exceptions：获取按文件分组的异常计数。
3. find_exceptions_in_file：获取特定文件中异常的详细追踪信息。
4. 自定义查询：
5. arbitrary_query：执行自定义 SQL 查询以分析追踪和指标数据。
6. 模式获取：
7. get_logfire_records_schema：获取 OpenTelemetry 的模式以帮助构建自定义查询。

适用场景

1. 应用程序性能监控和调试。
2. 分布式系统中的异常追踪和分析。
3. 通过 LLMs 自动化分析和报告应用程序的遥测数据。

工具列表

1. find_exceptions：按文件分组统计异常数量。
2. find_exceptions_in_file：获取特定文件中异常的详细追踪信息。
3. arbitrary_query：执行自定义 SQL 查询。
4. get_logfire_records_schema：获取 OpenTelemetry 数据模式。

常见问题解答

1. 如何获取 Logfire 读取令牌？
2. 在 Logfire 项目的设置页面中创建读取令牌。
3. 如何手动运行 MCP 服务器？
4. 使用 uvx logfire-mcp 命令，并通过环境变量或命令行参数指定读取令牌。
5. 如何配置 MCP 客户端？
6. 提供了 Cursor、Claude Desktop 和 Cline 的配置示例。

使用教程

使用依赖

1. 安装 uv： bash # 参考 https://docs.astral.sh/uv/getting-started/installation/ uv self update
2. 获取 Logfire 读取令牌：
3. 在 Logfire 项目设置中创建读取令牌。

安装教程

1. 运行 MCP 服务器： bash LOGFIRE_READ_TOKEN=YOUR_READ_TOKEN uvx logfire-mcp # 或 uvx logfire-mcp --read-token=YOUR_READ_TOKEN

调试方式

1. 验证服务器是否运行： bash # 检查进程是否运行 ps aux | grep logfire-mcp
2. 测试工具调用： bash # 示例：查找过去 30 分钟的异常 curl -X POST http://localhost:PORT -d '{"name": "find_exceptions", "arguments": {"age": 30}}'

许可证

该项目遵循 MIT 开源许可条款。