MCP server de Loggerhead
Commit 13 oct 2026Permite que un agente de codificación con IA lea y consulte logs, métricas y trazas de aplicaciones almacenadas en la app Loggerhead Mac.
También conocido como rubics-code/loggerhead-mcp, loggerhead-mcp
- Stars
- 0
- Herramientas
- 17
- Descargas, 30 días
- —
- Última versión
- 1.12.0
- Último commit
- 13 oct 2026
- Licencia
- MIT
¿Qué es Loggerhead MCP?
Loggerhead es un MCP server. Permite que un agente de codificación con IA lea y consulte logs, métricas y trazas de aplicaciones almacenadas en la app Loggerhead Mac. Expone 17 herramientas, como query_logs, query_metrics, query_traces.
Resumen generado a partir del README del proyecto
Acerca del MCP server de Loggerhead
Loggerhead proporciona un puente entre tus datos de telemetría locales y los agentes de codificación con IA. Conecta la app Loggerhead Mac con clientes MCP como Claude Desktop, Cursor, Windsurf y Claude Code. Esta configuración permite que un agente acceda a logs, métricas y trazas de OpenTelemetry que se almacenan en un archivo DuckDB local en tu máquina. Debido a que el servidor se ejecuta en la dirección loopback, tus datos permanecen en tu Mac y no salen del dispositivo.
Los desarrolladores utilizan este servidor para permitir que sus asistentes de IA inspeccionen el rendimiento de las aplicaciones y depuren problemas directamente desde la telemetría. El servidor incluye herramientas para consultar logs por severidad, buscar métricas de series temporales y examinar trazas específicas. También cuenta con herramientas especializadas para gestionar hallazgos de telemetry-lint, como logs ruidosos o secretos. Puedes usar estas herramientas para activar o desactivar reglas de lint, ajustar umbrales y marcar hallazgos específicos como corregidos después de haber aplicado cambios en el código.
Qué puedes hacer con él
- 1Depurar errores de aplicaciónPide a la IA que busque en los registros de logs recientes mensajes de error específicos o eventos de alta severidad.
- 2Analizar cuellos de botella de rendimientoSolicita un desglose detallado de cada span dentro de una traza específica para encontrar operaciones lentas.
- 3Gestionar reglas de telemetry lintingIndica al agente que cambie el umbral para una regla de lint específica en tu espacio de trabajo.
- 4Verificar correcciones de erroresDile a la IA que marque un hallazgo de telemetría como corregido después de haber actualizado el código.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Herramientas de Loggerhead MCP 17
Detectado desde el 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 | — |
Mostrar las 17 herramientasMostrar menos herramientas
add_lint_exceptionremove_lint_exceptionignore_findingunignore_findingmark_finding_fixed
| add_lint_exception | — | |
| remove_lint_exception | — | |
| ignore_finding | — | |
| unignore_finding | — | |
| mark_finding_fixed | — |
Verificaciones automáticas
Ejecutado 14 nov 2026Informe completo →Aún no verificado. Un servidor necesita una puntuación de 80, ningún hallazgo grave y suficientes datos para que podamos revisarlo. Cómo funcionan las verificaciones · Qué corregir para obtener más puntos
- Repositorio de origen vinculado y accesiblerubics-code/loggerhead-mcp is public and reachablegithub.com/rubics-code/loggerhead-mcp ↗Aprobado
- El paquete indica este repositorio como su origenNo verificado
- Procedencia de la compilación (atestación de Sigstore)No verificado
- Licencia de código abierto (OSI)MITspdx.org/licenses/MIT.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit or release 2026-10-13github.com/rubics-code/loggerhead-mcp ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo verificado
- No hay avisos críticos en el paquete ni en sus dependenciasNo verificado
- Sin instrucciones ocultas para el modelo17 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo verificado
- El endpoint remoto responde al handshake de MCPNo verificado
README
Ver en 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.
Preguntas sobre Loggerhead MCP
¿Qué herramientas proporciona Loggerhead MCP?
Expone 17 herramientas, incluidas query_logs, query_metrics, query_traces, get_trace, list_environments.
¿Necesito instalar algo más para usar esto?
Sí, la app Loggerhead Mac debe estar instalada y ejecutándose para que el MCP server funcione.
¿Se envían mis datos a la nube?
No, el servidor solo escucha en loopback y nada sale de tu Mac.
¿Cómo se conecta el servidor con la app?
El puente encuentra la app automáticamente utilizando una jerarquía fija de puertos locales.
¿Puedo cambiar las reglas de linting a través de la IA?
Sí, hay herramientas disponibles para activar/desactivar reglas de lint, establecer umbrales y añadir excepciones.