Serveur MCP Loggerhead
Commit 13 oct. 2026Permet à un agent de codage IA de lire et d'interroger les logs, les métriques et les traces d'application stockés dans l'application Loggerhead Mac.
Aussi connu sous rubics-code/loggerhead-mcp, loggerhead-mcp
- Étoiles
- 0
- Outils
- 17
- Téléchargements, 30 jours
- —
- Dernière version
- 1.12.0
- Dernier commit
- 13 oct. 2026
- Licence
- MIT
Qu'est-ce que Loggerhead MCP ?
Loggerhead est un serveur MCP. Permet à un agent de codage IA de lire et d'interroger les logs, les métriques et les traces d'application stockés dans l'application Loggerhead Mac. Il expose 17 outils, comme query_logs, query_metrics, query_traces.
Résumé généré à partir du README du projet
À propos du MCP server Loggerhead
Loggerhead fournit un pont entre vos données de télémétrie locales et vos agents de codage IA. Il connecte l'application Loggerhead Mac à des clients MCP tels que Claude Desktop, Cursor, Windsurf et Claude Code. Cette configuration permet à un agent d'accéder aux logs, métriques et traces OpenTelemetry stockés dans un fichier DuckDB local sur votre machine. Comme le serveur s'exécute sur l'adresse loopback, vos données restent sur votre Mac et ne quittent pas l'appareil.
Les développeurs utilisent ce serveur pour permettre à leurs assistants IA d'inspecter les performances applicatives et de déboguer des problèmes directement à partir de la télémétrie. Le serveur inclut des outils pour interroger les logs par niveau de sévérité, rechercher des métriques de séries temporelles et examiner des traces spécifiques. Il propose également des outils spécialisés pour gérer les résultats du linting de télémétrie, comme les logs trop verbeux ou les secrets. Vous pouvez utiliser ces outils pour activer ou désactiver des règles de lint, ajuster les seuils et marquer des résultats spécifiques comme résolus après avoir appliqué vos modifications de code.
Ce que vous pouvez faire avec
- 1Déboguer des erreurs applicativesDemandez à l'IA de parcourir les enregistrements de logs récents pour trouver des messages d'erreur spécifiques ou des événements de haute sévérité.
- 2Analyser les goulots d'étranglement de performanceDemandez une décomposition détaillée de chaque span au sein d'une trace spécifique pour identifier les opérations lentes.
- 3Gérer les règles de linting de télémétrieDonnez l'instruction à l'agent de modifier le seuil d'une règle de lint spécifique dans votre espace de travail.
- 4Vérifier les corrections de bugsDites à l'IA de marquer un résultat de télémétrie comme résolu après avoir mis à jour le code.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Outils MCP Loggerhead 17
Détectés depuis le 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 | — |
Afficher les 17 outilsAfficher moins d'outils
add_lint_exceptionremove_lint_exceptionignore_findingunignore_findingmark_finding_fixed
| add_lint_exception | — | |
| remove_lint_exception | — | |
| ignore_finding | — | |
| unignore_finding | — | |
| mark_finding_fixed | — |
Vérifications automatisées
Exécuté le 14 nov. 2026Rapport complet →Pas encore vérifié. Un serveur nécessite un score de 80, aucune faille sérieuse et suffisamment de données pour que nous puissions effectuer les vérifications. Fonctionnement des vérifications · Ce qu'il faut corriger pour gagner des points
- Dépôt source lié et accessiblerubics-code/loggerhead-mcp is public and reachablegithub.com/rubics-code/loggerhead-mcp ↗Réussi
- Le nom du package correspond au dépôt sourceNon vérifié
- Provenance du build (attestation Sigstore)Non vérifié
- Licence open source (OSI)MITspdx.org/licenses/MIT.html ↗Réussi
- Commit ou version publiée au cours de l'année écouléeLast commit or release 2026-10-13github.com/rubics-code/loggerhead-mcp ↗Réussi
- OpenSSF ScorecardNon vérifié
- Nom du package non proche d'un package populaireNon vérifié
- Aucun avis critique dans le package ou ses dépendancesNon vérifié
- Aucune instruction cachée destinée au modèle17 tool descriptions and the README read; no override phrases, credential paths or hidden charactersRéussi
- Les outils destructifs sont étiquetésNon vérifié
- Le point de terminaison distant répond à la poignée de main MCPNon vérifié
README
Voir sur GitHubLoggerhead 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.
Questions sur Loggerhead MCP
Quels outils Loggerhead MCP fournit-il ?
Il expose 17 outils, dont query_logs, query_metrics, query_traces, get_trace, list_environments.
Dois-je installer autre chose pour l'utiliser ?
Oui, l'application Loggerhead Mac doit être installée et en cours d'exécution pour que le MCP server puisse fonctionner.
Mes données sont-elles envoyées dans le cloud ?
Non, le serveur écoute uniquement sur l'interface loopback et rien ne quitte votre Mac.
Comment le serveur se connecte-t-il à l'application ?
Le pont trouve automatiquement l'application en utilisant une série de ports locaux prédéfinis.
Puis-je modifier les règles de linting via l'IA ?
Oui, des outils sont disponibles pour activer ou désactiver des règles de lint, définir des seuils et ajouter des exceptions.