Loggerhead

Loggerhead MCP 服务

你的编码 Agent 可以读取应用的日志、指标和追踪数据。

Loggerhead 是一款原生 Mac 应用，可接收你在自己的 Mac 上运行的软件发出的 OpenTelemetry 日志、指标和追踪数据，并将其存储在磁盘上的 DuckDB 文件中。MCP 服务在应用内部运行。本仓库包含 loggerhead-mcp，这是一个小型桥接程序，用于将 Claude、Cursor、Codex、Windsurf 或其他任何 MCP 客户端连接到它。

这些工具可以读取遥测数据。七个工具可以更改工作区的 lint 规则，每次更改都会附带用户可见的原因，且可在应用中撤销。一个工具会在代码更改后将发现标记为已修复。端点仅监听回环地址。没有任何数据会离开这台 Mac。

必须安装并运行 Loggerhead 应用。 请先下载。应用未运行时，桥接程序会退出。免费套餐包含 MCP 服务。

安装

Claude Desktop

从最新版本下载 loggerhead-mcp.mcpb 并打开。Claude Desktop 会安装该扩展。

Claude Code

claude mcp add loggerhead -- "/Applications/Loggerhead.app/Contents/Resources/loggerhead-mcp"

Cursor、Codex、Windsurf 及其他 stdio 客户端

所有 stdio 客户端使用相同的两个值。本仓库中的 .mcp.json 就是要复制的文件：

{
  "mcpServers": {
    "loggerhead": {
      "command": "/Applications/Loggerhead.app/Contents/Resources/loggerhead-mcp"
    }
  }
}

应用本身可以为你写入此条目：打开 设置 › AI，然后点击工具旁边的 添加。

桥接程序会按照固定顺序自动在本地端口上查找应用。你无需设置端口，也无需获得读取应用文件的权限。完整说明：设置 MCP 服务。

工具

工具	用途
query_logs	按文本、严重性和时间搜索日志记录。
query_metrics	按名称和时间范围读取时间序列指标。
query_traces	按服务、操作、持续时间和时间查找追踪数据。
get_trace	读取一条追踪的所有跨度。
list_environments	列出这台 Mac 上的所有工作区和环境，以及接收器端口。
get_receiver_info	报告生效的 OTLP 端口以及发送遥测数据的地址。
query_improvements	列出遥测 lint 发现：嘈杂的日志、无界标签、机密信息、丢失的追踪上下文。
list_lint_rules	列出工作区的 lint 规则及其状态、阈值、例外、已忽略的发现和近期更改。
query_ai_findings	列出最近一次 AI 分析运行的发现。此工具不会启动分析。
set_lint_rule_enabled	为工作区启用或停用 lint 规则，并附上原因。
set_lint_threshold	为工作区设置 lint 规则的一个阈值，并附上原因。
reset_lint_threshold	将工作区 lint 规则的一个阈值恢复为默认值，并附上原因。
add_lint_exception	为某项服务、指标、属性键、操作或日志消息隐藏某条 lint 规则的发现，并附上原因。
remove_lint_exception	移除一条例外规则，并附上原因。
ignore_finding	根据 ID 忽略一条 lint 发现，并附上原因。
unignore_finding	取消忽略一条 lint 发现，并附上原因。
mark_finding_fixed	代码更改后将一条 lint 发现标记为已修复，以便应用根据修复后的遥测数据判断它。

资源 loggerhead://stats 会报告日志、指标和跨度的总数。所有参数都列于工具参考。

隐私政策

桥接程序和服务会从同一台 Mac 上的 Loggerhead 应用读取遥测数据，并将其传递给你连接的 MCP 客户端。它们不会收集任何与你有关的信息，不会自行存储任何内容，不会与第三方共享任何内容，也不会打开连接到 127.0.0.1 之外的网络连接。数据保留由应用决定：遥测数据会保存在你磁盘上的 DuckDB 文件中，直到应用的保留设置将其清除；你也可以删除该文件。发布方 Rubics Code 的完整政策见 https://getloggerhead.com/privacy。联系方式：[email protected]。

注册表

此服务在注册表中的名称为 com.getloggerhead/loggerhead。

• MCP 注册表名称：mcp-name: com.getloggerhead/loggerhead

许可

loggerhead-mcp 桥接程序及此存储库中的文件采用 MIT 许可。

该桥接程序包含开源 Swift 软件包。.mcpb 捆绑包中包含 Acknowledgements.txt，其中列出了各软件包的许可文本和声明文本。

该桥接程序连接到 Loggerhead——由澳大利亚 Rubics Code（ABN 40 440 756 434）开发的专有 Mac 应用。该应用提供免费层级，且其源代码不公开。该应用受 Loggerhead 服务条款约束。