Server MCP la distanță pe VPS-ul dvs.: SDK Python, systemd, HTTPS prin Caddy și token Bearer
TipărirePe 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
- Drepturi de administrator (
root) pe un VPS. O mașină modestă, cu 1 vCPU și 1 GB RAM, face față fără probleme unui server MCP mic. - Un subdomeniu rezervat serverului, de pildă
mcp.domeniul-dvs.md, a cărui înregistrare A conține adresa IP a VPS-ului. Cum adăugați înregistrarea aflați din Înregistrarea A în cPanel: cum o adăugați, modificați sau ștergeți. - Python 3.10 sau o versiune ulterioară. Ubuntu 24.04 include deja Python 3.12.
- O sesiune SSH deschisă pe VPS. Dacă vă conectați pentru prima oară, urmați Prima conectare SSH la serverul VPS: pași și primele setări.
Cum se leagă componentele
| Componentă | Rolul ei aici |
|---|---|
| SDK-ul MCP pentru Python | Execută instrumentele dvs. și vorbește protocolul MCP, numai pe adresa internă |
| systemd | Lansează programul la pornirea sistemului și îl repornește dacă se oprește cu eroare |
| Caddy | Obține și reînnoiește certificatul SSL gratuit, verifică tokenul, transmite mai departe apelurile valide |
| ufw | Blochează 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
| Simptom | Cauza probabilă | Soluție |
|---|---|---|
| Eroarea 421 | Antetul Host nu a fost rescris | Readăugați rândul header_up și reîncărcați Caddy |
| Eroarea 401 | Tokenul lipsește sau diferă de cel din Caddyfile | Comparați cele două valori caracter cu caracter |
| Niciun răspuns | Serviciul Python s-a oprit sau a căzut | Citiț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
- Model Context Protocol (MCP) pentru proprietarii de site-uri: ce este și cum conectați în siguranță un asistent AI
- Protecția cheilor API în aplicațiile din cPanel și în WordPress: păstrare sigură și reacția la scurgeri
- Prima conectare SSH la serverul VPS: pași și primele setări
- VPS Pro (administrat) sau Unmanaged VPS: ce alegeți