Loggerhead MCP server
Commit 13 Okt 2026Memungkinkan AI coding agent untuk membaca dan melakukan query pada log aplikasi, metrik, serta trace yang tersimpan di aplikasi Loggerhead Mac.
Juga dikenal sebagai rubics-code/loggerhead-mcp, loggerhead-mcp
- Stars
- 0
- Tools
- 17
- Unduhan, 30 hari
- —
- Versi terbaru
- 1.12.0
- Commit terakhir
- 13 Okt 2026
- Lisensi
- MIT
Apa itu Loggerhead MCP?
Loggerhead adalah MCP server. Memungkinkan AI coding agent untuk membaca dan melakukan query pada log aplikasi, metrik, serta trace yang tersimpan di aplikasi Loggerhead Mac. Server ini menyediakan 17 tool, seperti query_logs, query_metrics, query_traces.
Ringkasan dibuat dari README proyek
Tentang Loggerhead MCP server
Loggerhead menyediakan bridge antara data telemetri lokal Anda dengan AI coding agent. Tool ini menghubungkan aplikasi Loggerhead Mac ke client MCP seperti Claude Desktop, Cursor, Windsurf, dan Claude Code. Setup ini memungkinkan agent untuk mengakses log, metrik, dan trace OpenTelemetry yang tersimpan dalam file DuckDB lokal di mesin Anda. Karena server berjalan pada alamat loopback, data Anda tetap berada di Mac Anda dan tidak keluar dari perangkat tersebut.
Developer menggunakan server ini agar asisten AI mereka dapat memeriksa performa aplikasi dan melakukan debug masalah secara langsung dari telemetri. Server ini menyertakan tool untuk melakukan query log berdasarkan tingkat keparahan (severity), mencari metrik time-series, dan memeriksa trace tertentu. Tersedia juga tool khusus untuk mengelola temuan telemetry-lint, seperti log yang terlalu berisik (noisy logs) atau rahasia (secrets). Anda dapat menggunakan tool ini untuk mengaktifkan atau menonaktifkan aturan lint, menyesuaikan threshold, dan menandai temuan tertentu sebagai sudah diperbaiki setelah Anda menerapkan perubahan kode.
Apa yang bisa Anda lakukan dengannya
- 1Debug error aplikasiMinta AI untuk mencari pesan error spesifik atau event dengan severity tinggi melalui catatan log terbaru.
- 2Analisis bottleneck performaMinta rincian mendalam dari setiap span dalam trace tertentu untuk menemukan operasi yang lambat.
- 3Kelola aturan telemetry lintingInstruksikan agent untuk mengubah threshold untuk aturan lint tertentu di workspace Anda.
- 4Verifikasi perbaikan bugBeritahu AI untuk menandai temuan telemetri sebagai fixed setelah Anda memperbarui kode.
Ditulis berdasarkan README proyek. Setiap use case diperiksa terhadap kutipan dari README tersebut.
Tool Loggerhead MCP 17
Terdeteksi dari 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 | — |
Tampilkan semua 17 toolTampilkan lebih sedikit tool
add_lint_exceptionremove_lint_exceptionignore_findingunignore_findingmark_finding_fixed
| add_lint_exception | — | |
| remove_lint_exception | — | |
| ignore_finding | — | |
| unignore_finding | — | |
| mark_finding_fixed | — |
Pengecekan otomatis
Berjalan 14 Nov 2026Laporan lengkap →Belum diverifikasi. Sebuah server memerlukan skor 80, tidak ada temuan serius, dan data yang cukup untuk kami periksa. Cara kerja checks · Yang perlu diperbaiki untuk menambah poin
- Source repository terhubung dan dapat dijangkaurubics-code/loggerhead-mcp is public and reachablegithub.com/rubics-code/loggerhead-mcp ↗Lolos
- Nama paket mencantumkan repositori ini sebagai sumbernyaTidak diperiksa
- Provenance build (atestasi Sigstore)Tidak diperiksa
- Lisensi open source (OSI)MITspdx.org/licenses/MIT.html ↗Lolos
- Ada commit atau release dalam satu tahun terakhirLast commit or release 2026-10-13github.com/rubics-code/loggerhead-mcp ↗Lolos
- OpenSSF ScorecardTidak diperiksa
- Nama package tidak mirip dengan package populerTidak diperiksa
- Tidak ada advisory kritis pada paket atau dependensinyaTidak diperiksa
- Tidak ada instruksi tersembunyi untuk model17 tool descriptions and the README read; no override phrases, credential paths or hidden charactersLolos
- Tools yang bersifat destruktif telah diberi labelTidak diperiksa
- Endpoint remote merespons handshake MCPTidak diperiksa
README
Lihat di 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.
Pertanyaan tentang Loggerhead MCP
Tool apa yang disediakan Loggerhead MCP?
Server ini menyediakan 17 tool, termasuk query_logs, query_metrics, query_traces, get_trace, list_environments.
Apakah saya perlu menginstal hal lain untuk menggunakannya?
Ya, aplikasi Loggerhead Mac harus sudah terinstal dan berjalan agar MCP server dapat berfungsi.
Apakah data saya dikirim ke cloud?
Tidak, server hanya mendengarkan pada loopback dan tidak ada data yang keluar dari Mac Anda.
Bagaimana server terhubung ke aplikasi?
Bridge ini secara otomatis menemukan aplikasi menggunakan urutan port lokal yang telah ditentukan.
Bisakah saya mengubah aturan linting melalui AI?
Ya, tersedia tool untuk mengaktifkan/menonaktifkan aturan lint, mengatur threshold, dan menambahkan pengecualian.