Loggerhead MCPサーバー
コミット 2026年10月13日Loggerhead Macアプリに保存されているアプリケーションのログ、メトリクス、トレースを、AIコーディングエージェントが読み取り、クエリできるようにします。
別名 rubics-code/loggerhead-mcp, loggerhead-mcp
- スター
- 0
- ツール
- 17
- ダウンロード数(30日間)
- —
- 最新バージョン
- 1.12.0
- 最終コミット
- 2026年10月13日
- ライセンス
- MIT
Loggerhead MCPとは
LoggerheadはMCPサーバーです。 Loggerhead Macアプリに保存されているアプリケーションのログ、メトリクス、トレースを、AIコーディングエージェントが読み取り、クエリできるようにします。. 17個のツールを提供しており、query_logs, query_metrics, query_tracesなどがあります。
プロジェクトのREADMEから生成された概要
Loggerhead MCP server について
Loggerheadは、ローカルのテレメトリデータとAIコーディングエージェントの間のブリッジを提供します。Loggerhead Macアプリを、Claude Desktop、Cursor、Windsurf、Claude CodeなどのMCPクライアントに接続します。この構成により、エージェントはマシン上のローカルなDuckDBファイルに保存されているOpenTelemetryのログ、メトリクス、トレースにアクセスできるようになります。サーバーはループバックアドレスで動作するため、データはMac内に留まり、デバイスから外部へ出ることはありません。
開発者はこのサーバーを使用して、AIアシスタントにテレメトリからアプリケーションのパフォーマンスを調査させたり、問題をデバッグさせたりできます。サーバーには、重要度別にログをクエリする、時系列メトリクスを検索する、特定のトレースを調査するといったツールが含まれています。また、ノイズの多いログや機密情報などのテレメトリリンティングの検出結果を管理するための専用ツールも備えています。これらのツールを使用して、lintルールの有効化/無効化、しきい値の調整、コード変更適用後の特定の検出結果の修正済みマーク付けを行うことができます。
できること
- 1アプリケーションエラーのデバッグAIに対して、最近のログレコードから特定のエラーメッセージや重要度の高いイベントを検索するよう指示します。
- 2パフォーマンスのボトルネック分析特定のトレース内のすべてのスパンの詳細な内訳を要求し、低速な操作を特定します。
- 3テレメトリリンティングルールの管理ワークスペース内の特定のlintルールのしきい値を変更するようエージェントに指示します。
- 4バグ修正の検証コードを更新した後、AIにテレメトリの検出結果を修正済みとしてマークするよう指示します。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
Loggerhead MCPツール 17
READMEから検出query_logsquery_metricsquery_tracesget_tracelist_environmentsget_receiver_infoquery_improvementslist_lint_rulesquery_ai_findingsset_lint_rule_enabledset_lint_thresholdreset_lint_threshold
| query_logs | — | |
| query_metrics | — | |
| query_traces | — | |
| get_trace | — | |
| list_environments | — | |
| get_receiver_info | — | |
| query_improvements | — | |
| list_lint_rules | — | |
| query_ai_findings | — | |
| set_lint_rule_enabled | — | |
| set_lint_threshold | — | |
| reset_lint_threshold | — |
17個のツールをすべて表示ツールを折りたたむ
add_lint_exceptionremove_lint_exceptionignore_findingunignore_findingmark_finding_fixed
| add_lint_exception | — | |
| remove_lint_exception | — | |
| ignore_finding | — | |
| unignore_finding | — | |
| mark_finding_fixed | — |
自動チェック
実行日 2026年11月14日完全なレポート →まだ検証されていません。サーバーには80点のスコア、重大な問題がないこと、および検証に必要な十分なデータが必要です。 チェックの仕組み · 点数を上げるための改善点
- ソースリポジトリがリンクされており、アクセス可能rubics-code/loggerhead-mcp is public and reachablegithub.com/rubics-code/loggerhead-mcp ↗合格
- パッケージがこのリポジトリをソースとして指定未チェック
- ビルドの来歴 (Sigstore 証明)未チェック
- オープンソースライセンス (OSI)MITspdx.org/licenses/MIT.html ↗合格
- 過去1年以内にコミットまたはリリースありLast commit or release 2026-10-13github.com/rubics-code/loggerhead-mcp ↗合格
- OpenSSF Scorecard未チェック
- パッケージ名が有名なパッケージに酷似していない未チェック
- パッケージおよびその依存関係に重大な勧告なし未チェック
- モデルへの隠れた指示がない17 tool descriptions and the README read; no override phrases, credential paths or hidden characters合格
- 破壊的なツールがラベル付けされている未チェック
- リモートエンドポイントが MCP ハンドシェイクに応答未チェック
README
GitHubで見るLoggerhead MCP server
Your coding agent reads your app's logs, metrics, and traces.
Loggerhead is a native Mac app that receives OpenTelemetry logs, metrics, and traces from the software you run on your own Mac, and stores them in a DuckDB file on your disk. The MCP server runs inside the app. This repository holds loggerhead-mcp, the small bridge that connects Claude, Cursor, Codex, Windsurf, or any other MCP client to it.
The tools read the telemetry. Seven tools change the lint rules of a workspace, each with a reason that the user sees and can undo in the app. One tool marks a finding fixed after a code change. The endpoint listens on loopback only. Nothing leaves the Mac.
The Loggerhead app must be installed and running. Download it first. The bridge exits when the app is not running. The free tier includes the MCP server.
Install
Claude Desktop
Download loggerhead-mcp.mcpb from the latest release and open it. Claude Desktop installs the extension.
Claude Code
claude mcp add loggerhead -- "/Applications/Loggerhead.app/Contents/Resources/loggerhead-mcp"
Cursor, Codex, Windsurf, and other stdio clients
Every stdio client takes the same two values. The .mcp.json in this repository is the file to copy:
{
"mcpServers": {
"loggerhead": {
"command": "/Applications/Loggerhead.app/Contents/Resources/loggerhead-mcp"
}
}
}
The app itself writes this entry for you: open Settings › AI and click Add beside your tool.
The bridge finds the app by itself on a fixed ladder of local ports. You set no port, and it needs no permission to read the app's files. Full instructions: Set up the MCP server.
Tools
| Tool | Purpose |
|---|---|
query_logs |
Search log records by text, severity, and time. |
query_metrics |
Read time-series metrics by name and time range. |
query_traces |
Find traces by service, operation, duration, and time. |
get_trace |
Read every span of one trace. |
list_environments |
List every workspace and environment on this Mac, with the receiver ports. |
get_receiver_info |
Report the effective OTLP ports and the addresses to send telemetry to. |
query_improvements |
List the telemetry-lint findings: noisy logs, unbounded labels, secrets, lost trace context. |
list_lint_rules |
List the lint rules of a workspace with their state, thresholds, exceptions, ignored findings, and recent changes. |
query_ai_findings |
List the findings of the last AI analysis run. It does not start a run. |
set_lint_rule_enabled |
Switch a lint rule on or off for a workspace, with a reason. |
set_lint_threshold |
Set one threshold of a lint rule for a workspace, with a reason. |
reset_lint_threshold |
Put one threshold of a lint rule back to its default, with a reason. |
add_lint_exception |
Hide the findings of one lint rule for a service, metric, attribute key, operation, or log message, with a reason. |
remove_lint_exception |
Remove one lint rule exception, with a reason. |
ignore_finding |
Ignore one lint finding by its id, with a reason. |
unignore_finding |
Stop the ignore of one lint finding, with a reason. |
mark_finding_fixed |
Mark one lint finding fixed after a code change, so the app judges it by the telemetry after the fix. |
One resource, loggerhead://stats, reports the total counts of logs, metrics, and spans. Every parameter is in the tools reference.
Privacy Policy
The bridge and the server read telemetry from the Loggerhead app on the same Mac and hand it to the MCP client you connected. They collect nothing about you, they store nothing of their own, they share nothing with a third party, and they open no network connection except to 127.0.0.1. Data retention is the app's: the telemetry lives in a DuckDB file on your disk for as long as the app's retention setting keeps it, and you can delete the file. The full policy of the publisher, Rubics Code, is at https://getloggerhead.com/privacy. Contact: support@getloggerhead.com.
Registry
The registry name of this server is com.getloggerhead/loggerhead.
- MCP Registry name:
mcp-name: com.getloggerhead/loggerhead
Licence
The loggerhead-mcp bridge and the files in this repository are under the MIT licence.
The bridge contains open-source Swift packages. The .mcpb bundle has Acknowledgements.txt with the licence text and the notice text of each package.
The bridge connects to Loggerhead, a proprietary Mac app by Rubics Code (ABN 40 440 756 434), Australia. The app has a free tier, and the source of the app is not public. The Loggerhead terms of service apply to the app.
Loggerhead MCPのよくある質問
Loggerhead MCPが提供するツールは
17個のツールを提供しており、query_logs, query_metrics, query_traces, get_trace, list_environmentsなどがあります。
これを使用するために、他に何かをインストールする必要がありますか?
はい、MCP serverを機能させるには、Loggerhead Macアプリがインストールされ、実行されている必要があります。
データはクラウドに送信されますか?
いいえ、サーバーはループバックでのみ待機しており、Macから外部へデータが送信されることはありません。
サーバーはどのようにアプリに接続しますか?
ブリッジがローカルポートの固定レイヤーを使用して、自動的にアプリを検出します。
AIを通じてリンティングルールを変更できますか?
はい、lintルールを有効化/無効化したり、しきい値を設定したり、例外を追加したりするためのツールが用意されています。