Skip to main content

Prerequisites

What you need before installing the MCP Server Suite.

Hardware​

  • Ubuntu server (20.04 LTS or later, 22.04 LTS recommended)
    • Minimum: 2 CPU cores, 4 GB RAM, 20 GB free disk
    • Recommended: 4 CPU cores, 8 GB RAM, 50 GB SSD
  • Synology NAS (optional): DSM 7.x on the same LAN as the Ubuntu server
  • Local machine: macOS, Linux, or Windows with Claude Code installed

Software​

All dependencies run inside Docker containers. You only need Docker on the host.

SoftwareVersionPurpose
Docker24.0+Container runtime
Docker Composev2 (plugin)Service orchestration
GitanyClone the repository
OpenSSH clientanyConnect from your Mac to the server

Python 3.12 and Node.js 22 are bundled inside the Docker images: you do not need them installed on the host.

Installing Docker​

# Ubuntu — official Docker install
curl -fsSL https://get.docker.com | sudo sh
sudo usermod -aG docker $USER
# Log out and back in for group change to take effect

Verify the installation:

docker --version # ≥ 24.0
docker compose version # must show "Docker Compose version v2.x"

Network​

  • SSH access from your local machine to the Ubuntu server (key-based authentication recommended)
  • Cloudflare Tunnel (recommended): A Cloudflare account with a domain, cloudflared installed on the server
  • Synology NAS (optional): The NAS must be reachable from the Ubuntu server on port 5001 (HTTPS). Typically both are on the same LAN.
# On your local machine
ssh-keygen -t ed25519 -C "mcp@your-server"
ssh-copy-id <UBUNTU_SERVER_USER>@<UBUNTU_SERVER_HOST>

Test the connection:

ssh <UBUNTU_SERVER_USER>@<UBUNTU_SERVER_HOST> "echo connected"

Account Credentials​

Before starting, gather these credentials:

ServiceWhat You Need
Synology NASUsername, password, and optional TOTP secret (if 2FA enabled). The account needs File Station access.
GitHubPersonal access token with repo and read:org scopes. Create at GitHub → Settings → Developer settings → Personal access tokens → Fine-grained tokens.
Cloudflare(Optional) API token or cloudflared login for tunnel setup.

Filesystem Preparation​

Create directories for logs and configs:

# On the Ubuntu server
sudo mkdir -p /var/log/mcp/{ubuntu,obsidian,synology,github}
sudo chown -R $USER:$USER /var/log/mcp

If using Obsidian, ensure your vault directory exists:

ls /DATA/obsidian-vaults/personal
# Should contain .md files

Knowledge Prerequisites​

You should be comfortable with:

  • Basic Docker commands (docker ps, docker compose up, docker compose logs)
  • Editing YAML configuration files
  • SSH and key-based authentication
  • Basic Linux command line

Next Step​

Proceed to Installation to deploy the stack.