Log Detective MCP
MCP server implementing core log analysis tools of Log Detective for use by other agents.
The server uses the Drain3 algorithm to cluster log messages into templates and extract a representative subset of snippets, reducing large logs to a manageable size for downstream analysis.
Installation
Requires Python 3.11+.
pip install .
Or with uv:
uv pip install .
Usage
Running the server
logdetective-mcp
Or directly:
python -m logdetective_mcp.main
MCP client configuration
Claude Code
claude mcp add logdetective -- logdetective-mcp
Claude Desktop
Add to your Claude Desktop configuration file:
{
"mcpServers": {
"logdetective": {
"command": "logdetective-mcp"
}
}
}
Tools
extract_log_snippets
Extracts representative log snippets using Drain3 clustering. The tool chunks the log into logical messages, clusters similar messages, and returns one representative snippet per cluster.
Log content can be provided in three ways (exactly one must be used):
| Parameter | Type | Description |
|---|---|---|
log_text |
str |
Raw log text passed directly. |
log_path |
str |
Path to a log file on the server's filesystem. |
log_url |
str |
HTTP(S) URL to fetch log content from. |
Optional parameters:
| Parameter | Type | Default | Description |
|---|---|---|---|
max_clusters |
int |
8 | Maximum number of snippets to extract. |
max_snippet_len |
int |
2000 | Maximum character length per snippet. |
skip_patterns |
dict[str, str] |
null |
Map of names to regex patterns. Matching chunks are excluded before clustering. |
Returns a list of Snippet objects, each with line_number (position in the original log) and text (the extracted snippet content).
Compressed file support
Both tools transparently decompress archived log files. Supported formats:
- Single-file compression:
.gz,.bz2,.xz,.lzma - Archives:
.zip,.tar,.tar.gz,.tar.bz2,.tar.xz
Format is detected from the file extension (or URL path). Archives must contain exactly one file.
Zip bomb protection is enforced via:
- Maximum decompressed size of 100 MB
- Maximum compression ratio of 100:1
- Pre-check of declared sizes in zip/tar headers
- No recursive decompression (nested archives are not unpacked)
Contributing
All changes to this repository must pass pre-commit checks and tests.
uv run pytest tests/
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file logdetective_mcp-0.2.1.tar.gz.
File metadata
- Download URL: logdetective_mcp-0.2.1.tar.gz
- Upload date:
- Size: 64.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.12.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
9021aa62e2d1f57f13a5b3896c75de969e0868770ccb4c0792229f56072c1666
|
|
| MD5 |
0343e84b857b328305e0c300b5c8216e
|
|
| BLAKE2b-256 |
cc0f94dcf0a49bcecb8f5a28306af6de131927f2f9265868bb4759967be99e31
|
Provenance
The following attestation bundles were made for logdetective_mcp-0.2.1.tar.gz:
Publisher:
publish.yml on fedora-copr/logdetective-mcp
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
logdetective_mcp-0.2.1.tar.gz -
Subject digest:
9021aa62e2d1f57f13a5b3896c75de969e0868770ccb4c0792229f56072c1666 - Sigstore transparency entry: 2205707525
- Sigstore integration time:
-
Permalink:
fedora-copr/logdetective-mcp@6bb830fc7673beee1f6eaa8cc3c652380ac9df7d -
Branch / Tag:
refs/tags/v0.2.1 - Owner: https://github.com/fedora-copr
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@6bb830fc7673beee1f6eaa8cc3c652380ac9df7d -
Trigger Event:
release
-
Statement type:
File details
Details for the file logdetective_mcp-0.2.1-py3-none-any.whl.
File metadata
- Download URL: logdetective_mcp-0.2.1-py3-none-any.whl
- Upload date:
- Size: 14.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.12.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
5544defae7a126895d0b96121fde68d06a3f20a75b5a1e8c9eb0464d9dd554bd
|
|
| MD5 |
12b52eeca38aa4f60ac4a4563f411c84
|
|
| BLAKE2b-256 |
93ca157e646bd51071c35200b0fb9383ff5a7479bf5a7c7e078f1fbe83a32af5
|
Provenance
The following attestation bundles were made for logdetective_mcp-0.2.1-py3-none-any.whl:
Publisher:
publish.yml on fedora-copr/logdetective-mcp
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
logdetective_mcp-0.2.1-py3-none-any.whl -
Subject digest:
5544defae7a126895d0b96121fde68d06a3f20a75b5a1e8c9eb0464d9dd554bd - Sigstore transparency entry: 2205707713
- Sigstore integration time:
-
Permalink:
fedora-copr/logdetective-mcp@6bb830fc7673beee1f6eaa8cc3c652380ac9df7d -
Branch / Tag:
refs/tags/v0.2.1 - Owner: https://github.com/fedora-copr
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@6bb830fc7673beee1f6eaa8cc3c652380ac9df7d -
Trigger Event:
release
-
Statement type:
