Loggerhead MCP server
2026년 10월 13일 커밋AI 코딩 에이전트가 Loggerhead Mac 앱에 저장된 애플리케이션 로그, 메트릭, 트레이스를 읽고 쿼리할 수 있도록 지원합니다.
다른 이름 rubics-code/loggerhead-mcp, loggerhead-mcp
- 스타
- 0
- Tools
- 17
- 다운로드, 30일
- —
- 최신 버전
- 1.12.0
- 마지막 커밋
- 2026년 10월 13일
- 라이선스
- MIT
Loggerhead MCP란?
Loggerhead은(는) MCP server입니다. AI 코딩 에이전트가 Loggerhead Mac 앱에 저장된 애플리케이션 로그, 메트릭, 트레이스를 읽고 쿼리할 수 있도록 지원합니다. 17개 도구를 제공합니다. 예: query_logs, query_metrics, query_traces.
프로젝트 README에서 생성된 요약
Loggerhead MCP server 정보
Loggerhead는 로컬 텔레메트리 데이터와 AI 코딩 에이전트 사이의 브릿지 역할을 합니다. Loggerhead Mac 앱을 Claude Desktop, Cursor, Windsurf, Claude Code와 같은 MCP 클라이언트에 연결합니다. 이 설정을 통해 에이전트는 기기의 로컬 DuckDB 파일에 저장된 OpenTelemetry 로그, 메트릭, 트레이스에 접근할 수 있습니다. 서버는 loopback 주소에서 실행되므로 데이터는 Mac에 머물며 기기 외부로 유출되지 않습니다.
개발자는 이 서버를 사용하여 AI 어시스턴트가 텔레메트리에서 직접 애플리케이션 성능을 점검하고 문제를 디버깅하도록 할 수 있습니다. 서버에는 심각도별 로그 쿼리, 시계열 메트릭 검색, 특정 트레이스 조사 도구가 포함되어 있습니다. 또한 노이즈가 심한 로그나 보안 비밀 정보와 같은 텔레메트리 린트(telemetry-lint) 탐지 결과를 관리하기 위한 특화된 도구도 제공합니다. 이 도구들을 사용하여 린트 규칙을 활성화 또는 비활성화하고, 임계값을 조정하며, 코드 변경 적용 후 특정 탐지 항목을 해결됨(fixed)으로 표시할 수 있습니다.
활용 사례
- 1애플리케이션 오류 디버깅AI에게 최근 로그 기록에서 특정 오류 메시지나 높은 심각도의 이벤트를 검색하도록 요청합니다.
- 2성능 병목 현상 분석느린 작업을 찾기 위해 특정 트레이스 내의 모든 span에 대한 상세 분석을 요청합니다.
- 3텔레메트리 린팅 규칙 관리에이전트에게 워크스페이스 내 특정 린트 규칙의 임계값을 변경하도록 지시합니다.
- 4버그 수정 확인코드를 업데이트한 후 AI에게 텔레메트리 탐지 항목을 해결됨으로 표시하도록 요청합니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
Loggerhead MCP 도구 17
README에서 감지됨query_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 | — |
도구 17개 모두 보기도구 수 줄이기
add_lint_exceptionremove_lint_exceptionignore_findingunignore_findingmark_finding_fixed
| add_lint_exception | — | |
| remove_lint_exception | — | |
| ignore_finding | — | |
| unignore_finding | — | |
| mark_finding_fixed | — |
자동 검사
2026년 11월 14일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능rubics-code/loggerhead-mcp is public and reachablegithub.com/rubics-code/loggerhead-mcp ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)검사되지 않음
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-10-13github.com/rubics-code/loggerhead-mcp ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음검사되지 않음
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
- 모델에 대한 숨겨진 지침 없음17 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
GitHub에서 보기Loggerhead 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 질문
Loggerhead MCP는 어떤 도구를 제공하나요?
17개 도구를 제공합니다. 예: query_logs, query_metrics, query_traces, get_trace, list_environments.
사용을 위해 다른 것을 추가로 설치해야 하나요?
네, MCP server가 작동하려면 Loggerhead Mac 앱이 설치되어 실행 중이어야 합니다.
데이터가 클라우드로 전송되나요?
아니요, 서버는 loopback에서만 리스닝하며 데이터는 Mac 외부로 나가지 않습니다.
서버가 앱에 어떻게 연결되나요?
브릿지가 고정된 로컬 포트 계층을 사용하여 앱을 자동으로 찾습니다.
AI를 통해 린팅 규칙을 변경할 수 있나요?
네, 린트 규칙 활성화/비활성화, 임계값 설정, 예외 추가를 위한 도구를 사용할 수 있습니다.