Loggerhead MCP server
Commit 13. Okt. 2026Ermöglicht es einem AI Coding Agent, Anwendungslogs, Metriken und Traces zu lesen und abzufragen, die in der Loggerhead Mac App gespeichert sind.
Auch bekannt als rubics-code/loggerhead-mcp, loggerhead-mcp
- Stars
- 0
- Tools
- 17
- Downloads, 30 Tage
- —
- Neueste Version
- 1.12.0
- Letzter Commit
- 13. Okt. 2026
- Lizenz
- MIT
Was ist Loggerhead MCP?
Loggerhead ist ein MCP server. Ermöglicht es einem AI Coding Agent, Anwendungslogs, Metriken und Traces zu lesen und abzufragen, die in der Loggerhead Mac App gespeichert sind. Er stellt 17 Tools bereit, etwa query_logs, query_metrics, query_traces.
Zusammenfassung generiert aus dem README des Projekts
Über Loggerhead MCP server
Loggerhead bietet eine Bridge zwischen deinen lokalen Telemetriedaten und AI Coding Agents. Es verbindet die Loggerhead Mac App mit MCP Clients wie Claude Desktop, Cursor, Windsurf und Claude Code. Dieses Setup erlaubt es einem Agenten, auf OpenTelemetry Logs, Metriken und Traces zuzugreifen, die in einer lokalen DuckDB-Datei auf deinem Rechner gespeichert sind. Da der Server auf der Loopback-Adresse läuft, bleiben deine Daten auf deinem Mac und verlassen das Gerät nicht.
Entwickler nutzen diesen Server, um ihren KI-Assistenten die Applikationsperformance zu inspizieren und Probleme direkt anhand der Telemetrie zu debuggen. Der Server enthält Tools, um Logs nach Schweregrad abzufragen, Zeitreihen-Metriken zu durchsuchen und spezifische Traces zu untersuchen. Zudem gibt es spezialisierte Tools für das Management von Telemetry-Lint-Findings, wie etwa verrauschte Logs oder Secrets. Du kannst diese Tools nutzen, um Lint-Regeln zu aktivieren oder zu deaktivieren, Schwellenwerte anzupassen und spezifische Findings als behoben zu markieren, nachdem du Code-Änderungen vorgenommen hast.
Was du damit machen kannst
- 1Anwendungsfehler debuggenBitte die KI, nach spezifischen Fehlermeldungen oder Ereignissen mit hohem Schweregrad in den aktuellen Log-Records zu suchen.
- 2Performance-Engpässe analysierenFordere eine detaillierte Aufschlüsselung jedes Spans innerhalb eines spezifischen Traces an, um langsame Operationen zu finden.
- 3Telemetry-Linting-Regeln verwaltenAnweisung an den Agenten, den Schwellenwert für eine spezifische Lint-Regel in deinem Workspace zu ändern.
- 4Bugfixes verifizierenSage der KI, ein Telemetry-Finding als behoben zu markieren, nachdem du den Code aktualisiert hast.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
Loggerhead MCP tools 17
Erkannt aus dem READMEquery_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 | — |
Alle 17 Tools anzeigenWeniger Tools anzeigen
add_lint_exceptionremove_lint_exceptionignore_findingunignore_findingmark_finding_fixed
| add_lint_exception | — | |
| remove_lint_exception | — | |
| ignore_finding | — | |
| unignore_finding | — | |
| mark_finding_fixed | — |
Automatisierte Checks
Geluften am 14. Nov. 2026Vollständiger Bericht →Noch nicht verifiziert. Ein Server benötigt einen Score von 80, keine kritischen Befunde und genug Daten für unsere Prüfung. Wie die Checks funktionieren · Was du für mehr Punkte verbessern kannst
- Source Repository verknüpft und erreichbarrubics-code/loggerhead-mcp is public and reachablegithub.com/rubics-code/loggerhead-mcp ↗Bestanden
- Paket nennt dieses Repository als QuelleNicht geprüft
- Build-Provenienz (Sigstore-Attestierung)Nicht geprüft
- Open Source Lizenz (OSI)MITspdx.org/licenses/MIT.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit or release 2026-10-13github.com/rubics-code/loggerhead-mcp ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNicht geprüft
- Keine kritischen Advisories im Paket oder seinen AbhängigkeitenNicht geprüft
- Keine versteckten Anweisungen an das Modell17 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNicht geprüft
- Remote-Endpoint beantwortet den MCP-HandshakeNicht geprüft
README
Auf GitHub ansehenLoggerhead 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 Fragen
Welche Tools bietet Loggerhead MCP?
Er stellt 17 Tools bereit, darunter query_logs, query_metrics, query_traces, get_trace, list_environments.
Muss ich zusätzlich noch etwas installieren?
Ja, die Loggerhead Mac App muss installiert und läuft, damit der MCP server funktioniert.
Werden meine Daten in die Cloud gesendet?
Nein, der Server lauscht nur auf Loopback und es verlässt nichts deinen Mac.
Wie verbindet sich der Server mit der App?
Die Bridge findet die App automatisch über eine feste Abfolge lokaler Ports.
Kann ich Linting-Regeln über die KI ändern?
Ja, es stehen Tools zur Verfügung, um Lint-Regeln zu aktivieren/deaktivieren, Schwellenwerte festzulegen und Ausnahmen hinzuzufügen.