docker-logs-mcp
MCP server for viewing Docker container logs on a remote VPS via SSH.
README
docker-logs-mcp
MCP server for viewing Docker container logs on a remote VPS via SSH. Tools optimized for tokens efficent
Requirements
- Python ≥ 3.12
- uv (package installer)
- SSH key access to the VPS
Quick Start
cd docker-logs-mcp
uv sync
Connecting to Cline
Add to Cline's MCP servers:
{
"docker-logs": {
"command": "uv",
"args": ["run", "--directory", "/path/to/docker-logs-mcp", "python", "-m", "src.docker_mcp"]
}
}
Where to add:
- VS Code:
~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.jsonor in Cline MCP config JSON - Cline Desktop: Settings → MCP Servers
Project Configuration
Each Docker project must have a .deploy file in its root:
SSH_HOST=user@server.com
PROJECT_DIR=/opt/project
SSH_PORT=22 # optional, defaults to 22
This file is also used by the deploy script (source ./.deploy).
Environment Variables
| Variable | Default | Description |
|---|---|---|
SSH_KEY |
~/.ssh/id_ed25519 |
Path to SSH private key |
Tools
| Tool | Parameters | Description | Server Command |
|---|---|---|---|
docker_logs |
project (req.), service (all), tail (500), errors_only (true), max_length (300) |
Latest Docker service logs. By default shows only WARNING/ERROR/CRITICAL, lines truncated to 300 chars — saves tokens | cd $PROJECT_DIR && docker compose logs --tail=N --no-color SERVICE |
docker_ps |
project (req.) |
Status of all project Docker containers | cd $PROJECT_DIR && docker compose ps --format json |
docker_stats |
project (req.) |
CPU and RAM usage of containers | cd $PROJECT_DIR && docker stats --no-stream --no-trunc --format json |
server_info |
project (req.) |
General VPS info: uptime, disk (df -h /), memory (free -h), container status |
uptime && df -h / && free -h && cd $PROJECT_DIR && docker compose ps |
docker_grep |
project (req.), pattern (req.), service (all), tail (500), context (0), ignore_case (false) |
Search logs with grep -E. More token-efficient than docker_logs for targeted search — returns only matching lines |
cd $PROJECT_DIR && docker compose logs --tail=N --no-color SERVICE | grep -E [flags] 'PATTERN' |
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.