docker-logs-mcp

docker-logs-mcp

MCP server for viewing Docker container logs on a remote VPS via SSH.

Category
Visit Server

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.json or 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

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.

Official
Featured
TypeScript
Audiense Insights MCP Server

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.

Official
Featured
Local
TypeScript
Magic Component Platform (MCP)

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.

Official
Featured
Local
TypeScript
VeyraX MCP

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official
Featured
Local
graphlit-mcp-server

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.

Official
Featured
TypeScript
Kagi MCP Server

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.

Official
Featured
Python
E2B

E2B

Using MCP to run code via e2b.

Official
Featured
Neon Database

Neon Database

MCP server for interacting with Neon Management API and databases

Official
Featured
Exa Search

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.

Official
Featured
Qdrant Server

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official
Featured