MCP server Loggerhead
Commit 13 de out. de 2026Permite que um agente de codificação de IA leia e consulte logs, métricas e traces de aplicações armazenados no app Loggerhead Mac.
Também conhecido como rubics-code/loggerhead-mcp, loggerhead-mcp
- Stars
- 0
- Ferramentas
- 17
- Downloads, 30 dias
- —
- Versão mais recente
- 1.12.0
- Último commit
- 13 de out. de 2026
- Licença
- MIT
O que é o MCP Loggerhead?
Permite que um agente de codificação de IA leia e consulte logs, métricas e traces de aplicações armazenados no app Loggerhead Mac. Ele expõe 17 ferramentas, como query_logs, query_metrics, query_traces.
Resumo gerado a partir do README do projeto
Sobre o MCP server de Loggerhead
O Loggerhead fornece uma ponte entre seus dados de telemetria locais e agentes de codificação de IA. Ele conecta o app Loggerhead Mac a clientes MCP como Claude Desktop, Cursor, Windsurf e Claude Code. Essa configuração permite que um agente acesse logs, métricas e traces do OpenTelemetry que estão armazenados em um arquivo DuckDB local na sua máquina. Como o servidor roda no endereço de loopback, seus dados permanecem no seu Mac e não saem do dispositivo.
Desenvolvedores utilizam este servidor para permitir que seus assistentes de IA inspecionem o desempenho da aplicação e depurem problemas diretamente pela telemetria. O servidor inclui ferramentas para consultar logs por severidade, pesquisar métricas de séries temporais e examinar traces específicos. Ele também possui ferramentas especializadas para gerenciar descobertas de telemetry-lint, como logs ruidosos ou segredos. Você pode usar essas ferramentas para ativar ou desativar regras de lint, ajustar limites e marcar descobertas específicas como corrigidas após aplicar mudanças no código.
O que você pode fazer com ele
- 1Depurar erros de aplicaçãoPeça à IA para pesquisar nos registros de log recentes por mensagens de erro específicas ou eventos de alta severidade.
- 2Analisar gargalos de performanceSolicite um detalhamento de cada span dentro de um trace específico para encontrar operações lentas.
- 3Gerenciar regras de telemetry lintingInstrua o agente a alterar o limite para uma regra de lint específica no seu workspace.
- 4Verificar correções de bugsDiga à IA para marcar uma descoberta de telemetria como corrigida após você ter atualizado o código.
Escrito a partir do README do projeto. Cada caso de uso é verificado com uma citação dele.
Ferramentas do MCP Loggerhead 17
Detectadas a partir do 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 todas as 17 ferramentasMostrar menos ferramentas
add_lint_exceptionremove_lint_exceptionignore_findingunignore_findingmark_finding_fixed
| add_lint_exception | — | |
| remove_lint_exception | — | |
| ignore_finding | — | |
| unignore_finding | — | |
| mark_finding_fixed | — |
Verificações automatizadas
Executado em 14 de nov. de 2026Relatório completo →Ainda não verificado. Um servidor precisa de uma pontuação de 80, nenhum problema grave e dados suficientes para verificarmos. Como as verificações funcionam · O que corrigir para ganhar mais pontos
- Repositório de origem vinculado e acessívelrubics-code/loggerhead-mcp is public and reachablegithub.com/rubics-code/loggerhead-mcp ↗Passou
- O pacote indica este repositório como sua origemNão verificado
- Proveniência da build (atestação Sigstore)Não verificado
- Licença de código aberto (OSI)MITspdx.org/licenses/MIT.html ↗Passou
- Commit ou release no último anoLast commit or release 2026-10-13github.com/rubics-code/loggerhead-mcp ↗Passou
- OpenSSF ScorecardNão verificado
- Nome do pacote não é próximo a um pacote popularNão verificado
- Nenhum aviso crítico no pacote ou em suas dependênciasNão verificado
- Sem instruções ocultas para o modelo17 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPassou
- Ferramentas destrutivas estão rotuladasNão verificado
- O endpoint remoto responde ao handshake do MCPNão verificado
README
Ver no 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.
Perguntas sobre o MCP Loggerhead
Quais ferramentas o MCP Loggerhead oferece?
Ele expõe 17 ferramentas, incluindo query_logs, query_metrics, query_traces, get_trace, list_environments.
Preciso instalar algo mais para usar isso?
Sim, o app Loggerhead Mac deve estar instalado e em execução para que o MCP server funcione.
Meus dados são enviados para a nuvem?
Não, o servidor escuta apenas no loopback e nada sai do seu Mac.
Como o servidor se conecta ao app?
A ponte encontra o app automaticamente usando uma sequência fixa de portas locais.
Posso alterar regras de linting através da IA?
Sim, existem ferramentas disponíveis para ativar/desativar regras de lint, definir limites e adicionar exceções.