Do It All MCP (diaMCP)

A versatile MCP server designed specifically for llama.cpp webui MCP integration. Simple to set up - just spin up the container and point your webui to the URL.

Why diaMCP?

When using llama-server's webui, you want tools without complexity. No servers to manage, no configuration files to write. Just:

1. docker compose up --build -d
2. Add the MCP URL to your webui
3. Done.

Installation

Option 1: Quick Install (Recommended)

Linux / macOS

curl -fsSL https://raw.githubusercontent.com/chartrambiz/diaMCP/main/install.sh | sh

Windows

irm https://raw.githubusercontent.com/chartrambiz/diaMCP/main/install.ps1 | iex

The script will:

• Check Docker and Docker Compose are installed
• Clone the repo if not present
• Build and start the container
• Show next steps

To update an existing installation, run the same command from within the diaMCP directory.

Option 2: Git Clone

Linux / macOS

# Clone the repository
git clone https://github.com/chartrambiz/diaMCP.git
cd diaMCP

# Start the container
docker compose up --build -d

Windows (PowerShell)

# Clone the repository
git clone https://github.com/chartrambiz/diaMCP.git
cd diaMCP

# Start the container
docker compose up --build -d

To update later:

git pull origin main 2>/dev/null || git pull origin master
docker compose up --build -d

Windows Setup Requirements

If using Windows, you need:

1. Docker Desktop for Windows

   • Download from https://docker.com/products/docker-desktop
   • Requires Windows 10/11 Pro, Enterprise, or Education
   • Enable WSL2 backend during installation

2. WSL2 (Windows Subsystem for Linux)

   • Open PowerShell as Administrator and run:

     wsl --install
     

   • Restart your computer when prompted
   • Ubuntu is recommended as your Linux distribution

3. After WSL2 setup

   • Open Ubuntu (or your chosen distro) from the Start menu
   • Run the installation commands above from within WSL2
   • All Linux/bash commands in this README will work as-is

Note: Running diaMCP directly in Windows Command Prompt or PowerShell (without WSL2) is not supported - the install scripts and container are designed for Linux environments.

Post-Installation Setup

After starting the MCP server container:

1. Start llama-server with MCP proxy enabled:

llama-server --webui-mcp-proxy -m model.gguf -c 32768 --host 0.0.0.0 --port 8080

2. In the llama.cpp webui:
   • Go to MCP Settings
   • Toggle "Enable llama-server proxy" ON
   • Add the MCP URL: http://localhost:8000/mcp

The MCP tools will be available in your chat.

Note: Files created in the workspace/ directory are owned by your user (UID 1000). If you need a different UID, edit docker-compose.yml and change the user: value.

Updating

After modifying custom tools or pulling new changes, rebuild and restart:

./restart.sh

This script rebuilds the container and verifies it's running.

Demo

See diaMCP in action with the llama.cpp webui:

File Operations

Web Search & Research

Features

• 21+ Built-in Tools: File operations, web search, git, shell, code execution, and more
• Dangerous Command Blocking: run_command blocks dangerous patterns (rm -rf, dd, mkfs, etc.)
• Elicitation Support: Confirmation prompts for risky commands (works with MCP clients that support it)
• Dynamic Tool Discovery: Drop Python files into ./workspace/tools/ or use built-in examples
• HTTP Transport: No stdio, no extra config - just a URL
• Persistent Workspace: Files and tools survive container restarts
• Works with llama-server webui: Designed for the MCP integration built into llama.cpp webui

Tools

File Operations

... View full README on GitHub