Server MCP la distanță pe VPS-ul dvs.: SDK Python, systemd, HTTPS prin Caddy și token Bearer

Tipărire
  • 0

Pe scurt: dacă doriți ca Claude sau alt asistent AI să apeleze instrumente de pe propriul server, de oriunde, serverul MCP trebuie să fie pornit tot timpul și accesibil prin HTTPS. Ghidul de mai jos construiește exact asta pe un VPS cu Ubuntu sau Debian: un mic program Python scris cu SDK-ul MCP, menținut în funcțiune de systemd, publicat prin Caddy cu certificat gratuit și păzit de un token secret. Socotiți aproximativ o jumătate de oră.

Înainte de a începe

Cum se leagă componentele

ComponentăRolul ei aici
SDK-ul MCP pentru PythonExecută instrumentele dvs. și vorbește protocolul MCP, numai pe adresa internă
systemdLansează programul la pornirea sistemului și îl repornește dacă se oprește cu eroare
CaddyObține și reînnoiește certificatul SSL gratuit, verifică tokenul, transmite mai departe apelurile valide
ufwBlochează toate porturile, în afară de SSH, HTTP și HTTPS

1. Instalați pachetele și un cont de sistem dedicat

Executați aceste comenzi ca root:

apt update && apt install -y python3-venv caddy ufw
useradd -r -m -d /opt/mcp -s /usr/sbin/nologin mcp
runuser -u mcp -- python3 -m venv /opt/mcp/venv
runuser -u mcp -- /opt/mcp/venv/bin/pip install "mcp[cli]>=1.20,<2"

Pe lângă uneltele Python, primul rând aduce Caddy și firewall-ul ufw. Contul numit mcp nu are shell de autentificare și nici drepturi de administrator, iar runuser execută următoarele două comenzi în numele lui, astfel că mediul virtual îi aparține. Chiar dacă cineva reușește să folosească abuziv serviciul, tot nu poate altera sistemul de operare.

2. Scrieți primul instrument

Salvați codul următor ca /opt/mcp/server.py. El oferă un singur instrument, care doar citește: raportează cât de plin este discul principal.

import shutil
from mcp.server.fastmcp import FastMCP

mcp = FastMCP("instrumente-vps", host="127.0.0.1", port=8000)

@mcp.tool()
def spatiu_disc() -> str:
    """Arată spațiul ocupat pe discul principal."""
    total, folosit, liber = shutil.disk_usage("/")
    return f"Folosit {folosit // 2**30} GB din {total // 2**30} GB"

if __name__ == "__main__":
    mcp.run(transport="streamable-http")

Exemplul este scris pentru seria 1.x a SDK-ului oficial MCP pentru Python. Fiindcă ascultă pe 127.0.0.1, nimeni din internet nu poate comunica direct cu el. Numai programele de pe VPS ajung la http://127.0.0.1:8000/mcp.

3. Mențineți-l pornit cu systemd

Descrieți serviciul în /etc/systemd/system/mcp.service:

[Unit]
Description=Server MCP
After=network.target

[Service]
User=mcp
WorkingDirectory=/opt/mcp
ExecStart=/opt/mcp/venv/bin/python /opt/mcp/server.py
Restart=on-failure

[Install]
WantedBy=multi-user.target

Încărcați-l și activați-l cu systemctl daemon-reload && systemctl enable --now mcp. De acum programul revine de la sine la fiecare repornire a VPS-ului. Ca să urmăriți în timp real ce afișează, tastați journalctl -u mcp -f.

4. Publicați-l prin HTTPS, în spatele unui token

Creați un secret aleatoriu cu openssl rand -hex 32, care afișează 64 de caractere hexazecimale. Introduceți-l în /etc/caddy/Caddyfile astfel:

mcp.domeniul-dvs.md {
    @autorizat header Authorization "Bearer TOKENUL_DVS"
    handle @autorizat {
        reverse_proxy 127.0.0.1:8000 {
            header_up Host 127.0.0.1:8000
        }
    }
    respond "Acces interzis" 401
}

Păstrați rândul header_up Host 127.0.0.1:8000. Un server MCP legat de 127.0.0.1 se apără refuzând apelurile al căror antet Host indică altă adresă. Fără această rescriere, Caddy ar transmite subdomeniul public, iar SDK-ul ar întoarce eroarea 421.

Aplicați modificarea cu systemctl reload caddy. Caddy își procură singur certificatul gratuit și îl reînnoiește ulterior fără intervenția dvs. Un apel fără tokenul exact primește 401 chiar de la Caddy și nu atinge deloc codul Python.

5. Închideți restul cu ufw

ufw allow 22/tcp
ufw allow 80/tcp
ufw allow 443/tcp
ufw enable

Verificați pe ce port ascultă serviciul SSH înainte să activați firewall-ul. Dacă nu este 22, permiteți acel număr în primul rând, altfel rămâneți blocat în afara VPS-ului. Portul 8000 rămâne închis permanent, fiindcă doar Caddy comunică local cu el.

6. Adăugați serverul în Claude Code

claude mcp add --transport http vps https://mcp.domeniul-dvs.md/mcp --header "Authorization: Bearer TOKENUL_DVS"

Conectorii web din Claude și din ChatGPT așteaptă de regulă OAuth, nu un token fix, ceea ce înseamnă un furnizor OAuth care rulează alături de acest server. SDK-ul MCP se descurcă și cu asta, însă este un proiect separat, pe care ghidul de față nu îl acoperă.

Depanare

SimptomCauza probabilăSoluție
Eroarea 421Antetul Host nu a fost rescrisReadăugați rândul header_up și reîncărcați Caddy
Eroarea 401Tokenul lipsește sau diferă de cel din CaddyfileComparați cele două valori caracter cu caracter
Niciun răspunsServiciul Python s-a oprit sau a căzutCitiți jurnalul cu journalctl -u mcp -f

Întrebări des întâlnite

Python este singura variantă?

Nu, există și un SDK oficial pentru TypeScript. Unitatea systemd, configurarea Caddy și regulile de firewall funcționează identic cu un program Node.js.

Ce este sigur să puneți la dispoziția asistentului?

Porniți de la instrumente care doar citesc: dacă serviciile funcționează, spațiul liber pe disc, erorile recente din jurnale. Nu scrieți niciodată un instrument care execută orice comandă primește, deoarece așa îi predați asistentului întregul server.

Cum înlocuiți un token vechi sau compromis?

Generați unul proaspăt, puneți-l în Caddyfile în locul celui vechi, rulați systemctl reload caddy și lipiți-l în aplicația AI. Caddy respinge imediat valoarea anterioară.

Merge și pe un plan de găzduire web partajată?

Nu. Găzduirea partajată nu oferă acces root, deci Caddy nu poate fi instalat, iar serviciile de lungă durată nu pot fi pornite. Pentru a alege tipul potrivit de VPS, consultați VPS Pro (administrat) sau Unmanaged VPS: ce alegeți.

Articole utile

Răspunsul a fost util?