SELF2025

Example scripts and resources for my presentation on LLMs using MCP tools at SELF2025

Presentation Video: https://www.youtube.com/watch?v=PCRygWoQCN4

File Descriptions

Python Files

If you use these python scripts yourself, make sure to replace the example server urls for certain extra lookup services that are used.

system_tools.py

A FastMCP server that provides Docker container management tools. Functions include:

• List containers
• Check if containers are running
• Retrieve container logs
• Get container stats
• Restart containers
• Access MCP Resources:
  • Docker compose files
  • Text files
  • System IP addresses
  • Date/time information
  • System information

network_tools.py

A FastMCP server providing network-related tools. Functions include:

• Domain lookups
• IP lookups
• Ping tests
• HTTP GET testing
• DNS checking
• IP address listing
• Service monitoring
• Access MCP Resource
  • System IP Addresses

smolagents_sysadmin_examples.py

Demonstrates how to use SmolAgents with MCPAdapt to interact with MCP servers. The example shows how to check and fix a service running in a Docker container, using LLMs to perform system administration and diagnostic tasks.

Example Run: https://asciinema.org/a/8YdOS2KoQXTGVNDzeVtWIrvyw

YAML Files

mcp-proxy-tools.yml

Docker Compose configuration for running the MCP server tools as containers:

• mcp-proxy-network: Runs the network_tools.py script, exposing port 8097
• mcp-proxy-system: Runs the system_tools.py script, exposing port 8098, with access to Docker socket

Dockerfile

mcp-proxy_tools.Dockerfile

Builds the container image used by the MCP proxy services:

• Based on the mcp-proxy base image
• Installs necessary Python packages (psutil, mcp[cli], requests, docker)
• Sets up the environment for running MCP services

Example Usage

The repository includes example scripts showing how an LLM can be used to:

• Monitor and repair Docker containers (e.g., fixing the "homebox" service)
• Perform network diagnostics
• Retrieve system information

Additional Resources

Personal Informational MCP server

Code: https://github.com/Red5d/me-mcp

Live: https://mcp.red5d.dev/sse

MCP-capable client software

• https://www.pulsemcp.com/clients
• https://github.com/punkpeye/awesome-mcp-clients

Where to find MCP servers to run/use:

• MCP Github: https://github.com/modelcontextprotocol/servers
• Docker Hub: https://hub.docker.com/catalogs/mcp
• Glama: https://glama.ai/mcp/servers
• Smithery: https://smithery.ai/
• Pipedream: https://mcp.pipedream.com/
• GitHub Awesome List: https://github.com/punkpeye/awesome-mcp-servers