Loggerhead

Loggerhead MCP サーバー

コーディングエージェントがアプリのログ、メトリクス、トレースを読み取ります。

Loggerhead は、Mac 上で実行するソフトウェアから OpenTelemetry のログ、メトリクス、トレースを受信し、ディスク上の DuckDB ファイルに保存するネイティブ Mac アプリです。MCP サーバーはアプリ内で動作します。このリポジトリには、Claude、Cursor、Codex、Windsurf、その他の MCP クライアントをアプリに接続する小さなブリッジ loggerhead-mcp が含まれています。

ツールはテレメトリを読み取ります。7 つのツールでワークスペースの 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 クライアントで使用する値は同じ 2 つです。このリポジトリの .mcp.json がコピーするファイルです。

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

アプリがこのエントリを自動で設定します。Settings › AI を開き、ツールの横にある Add をクリックしてください。

ブリッジは、固定されたローカルポートの順にアプリを自動で検出します。ポートを設定する必要はなく、アプリのファイルを読み取る権限も必要ありません。詳しい手順は、MCP サーバーのセットアップをご覧ください。

ツール

ツール	目的
query_logs	テキスト、重大度、時刻でログレコードを検索します。
query_metrics	名前と時間範囲で時系列メトリクスを読み取ります。
query_traces	サービス、操作、所要時間、時刻でトレースを検索します。
get_trace	1 つのトレースのすべてのスパンを読み取ります。
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 ルールのしきい値を 1 つ設定します。
reset_lint_threshold	理由を記録して、ワークスペースの lint ルールのしきい値を 1 つ既定値に戻します。
add_lint_exception	理由を記録して、サービス、メトリクス、属性キー、操作、ログメッセージに関する 1 つの lint ルールの検出項目を非表示にします。
remove_lint_exception	理由を記録して、lint ルールの例外を 1 つ削除します。
ignore_finding	理由を記録して、ID で指定した lint の検出項目を 1 つ無視します。
unignore_finding	lint の検出項目 1 つに対する無視を解除します。理由を記録します。
mark_finding_fixed	コード変更後に lint の検出項目を 1 つ修正済みとしてマークします。アプリは修正後のテレメトリに基づいて判定します。

1 つのリソース 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 が含まれています。

ブリッジは、オーストラリアの Rubics Code（ABN 40 440 756 434）が提供するプロプライエタリな Mac アプリ、Loggerhead に接続します。アプリには無料プランがあり、アプリのソースコードは公開されていません。アプリには Loggerhead の利用規約が適用されます。