README Documentation
CLP MCP Server
A model context protocol server to work with accessing Compressed Log Processor (CLP).
Getting Started
Option 1 (Easiest): Use uv package manager
Step 1: Install uv package manager.
Step 2: Clone this repository (e.g., to "C:\mcp-server-clp")
Step 3: Configure your editor
Cursor
Copy the following contents to Menu Bar -> File -> Preferences -> Cursor Settings -> Tools & Integrations -> MCP Tools -> Add Custom MCP
{
"mcpServers": {
"CLP file reader": {
"command": "uv",
"args": [
"--directory",
"C:\\mcp-server-clp", // or "/home/user_name/mcp-server-clp"
"run",
"python",
"-m",
"mcp_server_clp",
"C:\\path_to_log_files" // replace this path
]
}
}
}
Visual Studio Code (with Copilot)
-
Open command palette with
Ctrl + Shift + P
. -
Choose
MCP: Add Server...
. -
Choose
Command (stdio) Run a local command that implements the MCP protocol
. -
Type
uv --directory C:\mcp-server-clp run python -m mcp_server_clp C:\path_to_log_files
. -
Type the name of the server, e.g.,
mcp-server-clp
. -
You should end up with a file looking like
{
...
"mcp": {
"servers": {
"mcp-server-clp": {
"type": "stdio",
"command": "uv",
"args": [
"--directory",
"C:\\mcp-server-clp", // or "/home/user_name/mcp-server-clp"
"run",
"python",
"-m",
"mcp_server_clp",
"C:\\path_to_log_files" // replace this path
]
},
}
}
}
Claude Desktop
Copy the following contents to claude_desktop_config.json
by Menu Bar -> File -> Settings -> Developer -> Edit Config
{
"mcpServers": {
"CLP file reader": {
"command": "uv",
"args": [
"--directory",
"C:\\mcp-server-clp", // or "/home/user_name/mcp-server-clp"
"run",
"python",
"-m",
"mcp_server_clp",
"C:\\path_to_log_files" // replace this path
]
}
}
}
Option 2: If you already have a Python and Node.js environment
Show steps
Step 1: Clone this repository
Step 2: Setup a venv and install dependencies in pyproject.toml
python -m venv venv
. ./venv/bin/activate
pip install .
Step 3: Run the MCP server in server mode
python -m mcp_server_clp /home/user_name/path_to_log_files --sse --host localhost --port 8000
Step 4: Configure your editor
Copy the following contents to your mcp configuration file. You can find more details in Step 3 of Option 1.
{
"mcpServers": {
"CLP file reader": {
"command": "npx",
"args": [
"mcp-remote",
"http://localhost:8000/sse"
]
}
}
}
Example Prompts
Here are some example prompts you can use:
-
Please list all files accessible through CLP mcp server.
-
Read
example.clp.zst
file and summarize the log file. -
Locate the error in
example.clp.zst
log file.