android-log-mcp
Project goals: docs/GOALS.md · Changes and upgrade notes: CHANGELOG.md · Contributor / agent guidelines: · Terms:
Power your agent
คำสั่งของผู้เผยแพร่เอง ไม่ใช่เอนด์พอยต์ของ PlugMCP
Host a copy with our keys and logs.
npx -y [email protected]Claude Code ไม่มีลิงก์ติดตั้งสำหรับคำสั่งแบบโลคัล ให้คัดลอกคำสั่งด้านล่างแล้วรันในเทอร์มินัล
claude mcp add android-log-mcp -- npx -y android-log-mcp@0.12.1รันในเทอร์มินัล
{ "mcpServers": { "android-log-mcp": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}claude_desktop_config.json
URL แบบรีโมตหรือคำสั่งบนเครื่องของคุณ? การติดตั้งสองแบบต่างกันอย่างไร
รันบน PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
เปิดจากผู้เผยแพร่
Project goals: docs/GOALS.md · Changes and upgrade notes: CHANGELOG.md · Contributor / agent guidelines: · Terms:
MCP stdio server that gives AI agents (Claude Code, Codex, Cursor) read-only access to Android logcat: background recording, Android Studio filter syntax, crash/ANR grouping, app launch timelines.
An MCP (Model Context Protocol) stdio server that gives AI coding agents (MCP hosts such as Claude Code, Codex CLI, Cursor, …) read-only access to Android logcat. It never clears logs, never starts or stops apps (except report --am-start, only when you ask) and never changes device settings.
android-log-mcp record --for 2h keeps recording without calls.tag: message~: -package: level: age: is:crash | &, parentheses) with strict errors: a parse error gives the column and a fix instead of silently degrading to a substring match, and every response first echoes how the filter was parsed.dumpsys dropbox where available.START u0, am_proc_start, am_on_*_called (API ≤ 29) / wm_on_*_called (API ≥ 30), Displayed and Fully drawn.logcat_export / android-log-mcp export write the matching lines to a text file for a human to read (unredacted unless asked; docs/reference.md).android-log-mcp report packs logs and diagnostics into a zip with sensitive data redacted by default.Prebuilt binaries for Linux, macOS and Windows (x64, arm64). Requires adb.
中文摘要: android-log-mcp 是一个 MCP stdio server,让 AI agent(MCP 宿主,如 Claude Code / Codex / Cursor 等)只读地访问 Android logcat:不清空日志、不启动或停止应用(report --am-start 除外,且只在你明确要求时)、不改设备设置。
安装:npx -y android-log-mcp(Windows 推荐原生二进制)。工具说明见 docs/tools.md,服务进程、数据与环境变量见 docs/reference.md,兼容性见 docs/compatibility.md,升级说明只在 CHANGELOG.md。
Prerequisites: adb (Android SDK platform-tools); Node.js ≥ 16 for npx (not needed for the native binary). Windows needs Windows 10 1803 / Windows Server 2019 or later. Go is not needed. adb is found via ANDROID_LOG_MCP_ADB, then PATH, then the usual SDK locations. Details, both install paths and the upgrade procedure: docs/reference.md.
npx -y android-log-mcp --version # check that it runs
npx -y android-log-mcp call logcat_status '{}' # debugging: call one tool and print the result
macOS / Linux
Codex (~/.codex/config.toml; the Codex CLI and IDE extension share it):
[mcp_servers.android-log]
command = "npx"
args = ["-y", "android-log-mcp"]
# env = { ANDROID_LOG_MCP_ADB = "/path/to/adb" }
Cursor (~/.cursor/mcp.json or the project's .cursor/mcp.json) and Claude Code (the project's .mcp.json):
{
"mcpServers": {
"android-log": { "command": "npx", "args": ["-y", "android-log-mcp"] }
}
}
or claude mcp add android-log -- npx -y android-log-mcp.
Windows: the same configuration works (npx resolves to npx.cmd); if the host cannot start it, use "command": "cmd", "args": ["/c", "npx", "-y", "android-log-mcp"], or use B.
npx -y android-log-mcp@latest install # copies the binary to a fixed path and prints it
Without Node.js, download the tarball from GitHub Releases. Then point the MCP host at the absolute path with no args, for example Cursor / Claude Code on Windows:
{
"mcpServers": {
"android-log": { "command": "C:\\Users\\<you>\\AppData\\Local\\android-log-mcp\\exe\\android-log-mcp.exe", "args": [] }
}
}
Paths for every OS, Codex and claude mcp add variants, and why B is better on Windows: docs/reference.md.
All times in from / to / age: are device time; output is in the device's time zone. Parameters, time semantics, the package parameter and several devices: docs/tools.md. Reproducing a bug: call logcat_status for a cursor, let the user reproduce, then logcat_search(after=cursor, wait_ms=20000). cursor is the newest stored line at the time of the call; after=cursor is exclusive (only lines stored after it) and before=cursor pages older (only lines before it).
tag:OkHttp contains (case-insensitive, Android Studio semantics)
tag=:MainActivity exact match
message~:"timeout \d+ms" regex (RE2: no backreferences or lookaround; errors say so)
-tag:chatty exclude
level:warn age:5m is:crash is:stacktrace
pid:1234 tid:1234 buffer:crash (extensions of this project)
tag:A | tag:B (tag:A | level:error) & package:com.foo
The same key repeated is OR (tag:A tag:B = A or B); different keys are AND. Unknown keys, && / ||, unbalanced parentheses and unquoted foo:bar are errors.
Precedence: | binds tighter than the space (implicit AND), so tag:A level:error | tag:B is tag:A & (level:error | tag:B); write (tag:A & level:error) | tag:B to OR whole groups. OR / AND are not operators: a bare OR is a message keyword (use | and &). A value with spaces needs quotes: message:'rate limit' (single or double); unquoted, message:rate limit is message:rate AND a line containing limit.
<user cache dir>/android-log-mcp (android-log-mcp root); 1 day and 512 MiB per device by default. See docs/reference.md.android-log-mcp record --for 2h. See docs/reference.md.npx on Windows. Use cmd /c npx … or the native binary (B).android-log-mcp report writes a zip with sensitive data redacted: docs/reference.md.android-log-mcp export --out /abs/path/log.txt [--min-level W --from 14:00 --package com.foo] writes the matching lines as logcat -v threadtime -v year text. It is not redacted unless you pass --redact (the opposite of report): docs/reference.md.MIT © s1crab. server/third_party_ref/ is Apache-2.0 reference source and is not compiled.
MCP stdio server that gives AI agents (Claude Code, Codex, Cursor) read-only access to Android logcat: background recording, Android Studio filter syntax, crash/ANR grouping, app launch timelines.
{ "mcpServers": { "android-log-mcp": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}เครื่องมือ
ยังไม่มีรายการเครื่องมือ เซิร์ฟเวอร์แบบรีโมตจะได้รายการหลังการตรวจสอบสถานะครั้งแรก
FAQ
คัดลอกคอนฟิก stdio สำหรับ Cursor, Claude Desktop, Claude Code หรือ VS Code ได้ในหน้านี้ คอนฟิกนี้ใช้การติดตั้งของผู้เผยแพร่ ไม่ใช่พร็อกซีของ PlugMCP
ระเบียนนี้ไม่ได้ระบุตัวแปรสภาพแวดล้อมที่จำเป็น
Android Log ทำงานแบบโลคัลผ่าน stdio
ตรวจสอบล่าสุดเมื่อ 2026-11-16 MCP stdio server that gives AI agents (Claude Code, Codex, Cursor) read-only access to Android logcat: background recording, Android Studio filter syntax, crash/ANR grouping, app launch timelines.