🚀 Logfire MCP 服务器
本仓库涵盖一个模型上下文协议 (MCP) 服务器，配备相关工具，可用于访问您发送至 Logfire 的 OpenTelemetry 跟踪和指标数据。
🚀 快速开始
- 获取 Logfire 访问令牌：访问 Logfire 控制台，创建并获取访问令牌。
- 启动 MCP 服务器：
uvx logfire-mcp --read-token=YOUR_TOKEN
- 配置客户端：依据您所使用的工具（如 Cursor、Claude Desktop 或 Cline），参考对应的配置示例进行设置。
- 开始使用：运用 MCP 服务器提供的工具，对您的 OpenTelemetry 跟踪和指标数据展开分析。
✨ 主要特性
Logfire MCP 服务器具备以下功能：
- 分析跟踪数据：助力您识别并分类应用程序中的异常情况。
- 查询指标：提供灵活的查询功能，协助您获取所需数据。
- 集成工具：支持与多种开发环境和框架集成。
📦 安装指南
此部分可参考快速开始中的步骤，先获取 Logfire 访问令牌，再启动 MCP 服务器，最后配置客户端即可开始使用。
💻 使用示例
基础用法
以下是 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
}
]
高级用法
以下是一些示例问题，展示如何使用这些工具解决实际问题：
- “过去一小时所有服务中发生了哪些异常？”
- “请展示文件 'app/api.py' 中最近的错误及其上下文跟踪信息。”
- “昨天每分钟发生了多少次错误？”
- “按服务名称分类，最常见的异常类型有哪些？”
- “获取 OpenTelemetry 跟踪和指标的架构信息”
- “查找昨天所有错误并展示其上下文跟踪信息”
📚 详细文档
项目贡献
我们热忱欢迎社区贡献，无论您是想增添新功能、修复问题还是完善文档，都欢迎您参与。 请参考 模型上下文协议服务器仓库 获取更多实现示例和开发模式。
📄 许可证
Logfire MCP 服务器采用 MIT 许可证。这意味着您可在任何项目中自由使用、修改和分发该软件，但需遵循 MIT 许可证的条款。