Content
# logpiper
[![npm]](https://www.npmjs.com/package/logpiper-mcp)
[npm]: https://img.shields.io/npm/v/logpiper-mcp.svg?style=flat-square
Logpiper is an MCP server and client for streaming terminal command logs with proactive error notifications
## Features
🚀 **Multi-Session Support**: Run multiple `logpiper` instances simultaneously across different terminals
📊 **Real-time Streaming**: Only delivers new, unfetched logs via cursor-based streaming
📢 **Proactive Notifications**: Automatic alerts to Claude Code
## Installation
Install npm package `logpiper-mcp` to access both components:
```bash
npm install -g logpiper-mcp
```
This provides:
- **CLI tool**: `logpiper` command for log collection
- **MCP server**: `logpiper-mcp` for IDE integration
- **Claude Code agent**: Install the monitoring agent with `logpiper --install-agent`
### Agent Installation
To install the Claude Code monitoring agent:
```bash
logpiper --install-agent
```
This will interactively guide you through installing the logpiper-monitor agent to your Claude Code agents directory.
### MCP Server Configuration
Add `logpiper` to your IDE configuration, e.g. `~/.claude/settings.json`:
```json
{
"mcpServers": {
"logpiper": {
"command": "logpiper-mcp"
}
}
}
```
## Usage
### 1. Start monitoring any command by prefixing it with `logpiper`:
#### Testing and CI/CD
```bash
# Monitor test suites
logpiper npm test
logpiper npm run test:watch
logpiper npm run test:e2e
# Monitor build processes
logpiper npm run build
logpiper npm run build:prod
```
#### Docker and Container Monitoring
```bash
# Monitor Docker Compose services
logpiper docker-compose up
logpiper docker-compose logs -f backend
# Monitor individual containers
logpiper docker logs -f container_name
```
#### Database and Backend Services
```bash
# Monitor Python applications
logpiper python app.py
logpiper uvicorn main:app --reload
# Monitor Node.js servers
logpiper node server.js
logpiper nodemon app.js
```
### 3. MCP Tools Available
| Tool | Description | Usage |
|------|-------------|-------|
| `get_new_logs` | Get new logs since cursor position (streaming) | Real-time log monitoring |
| `list_sessions` | List all logging sessions with metadata | Session management |
| `search_logs` | Search through logs with query string | Error investigation |
| `get_logs_paginated` | Get logs with cursor-based pagination and automatic chunking | Large log file navigation |
| `cleanup_sessions` | Cleanup sessions: smart cleanup based on criteria or complete reset | Session management (mode: "smart" or "all") |
### Additional Features
🔒 **Token Limiting**: MCP responses automatically limited to 25,000 tokens to prevent overwhelming Claude Code
## Contributing
1. Fork the repository
2. Create a feature branch
3. Add your improvements
4. Test with multiple command types
5. Submit a pull request
## License
MIT License - feel free to use and modify for your needs!
MCP Store