Как да стартирате MCP на EuroVDC Sofia VPS

Собствен или трети MCP (не само eurovdc-mcp) на Sofia VPS? Вижте Хостване на MCP сървър на EuroVDC Sofia VPS.

Стартирането на Model Context Protocol (MCP) сървър на EuroVDC Cloud VPS в София ви позволява да изложите Claude, Cursor или собствен агентски стек през HTTPS без tunnel продукт. Това ръководство описва production-близка инсталация на open-source хранилището eurovdc-mcp.

EuroVDC вече има публичен MCP endpoint на /mcp. При self-hosting на вашия VPS вие контролирате домейн, TLS, процеса и логовете. Стъпките са за Sofia NVMe cloud планове и важат и за други EuroVDC VPS размери.

За кого е подходящо

• Екипи, които искат да дадат на Claude Desktop или Cursor собствен MCP URL
• Оператори, които предпочитат EU хостинг в София без tunnel от трети страни
• Строители, които излагат domain, hosting и cart инструменти от собствена инфраструктура

1. Поръчайте Sofia Cloud / VPS план

Започнете със Sofia Cloud Server със статичен IP. Ще пуснете Node MCP процеса плюс Nginx или Caddy, затова 1 vCPU и 2 GB RAM са комфортен старт. След поръчка се свържете по SSH и обновете системата.

sudo apt update && sudo apt upgrade -y
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs git nginx certbot python3-certbot-nginx
node -v && npm -v

2. Клонирайте хранилището и инсталирайте зависимости

sudo mkdir -p /opt/eurovdc-mcp
sudo chown $USER:$USER /opt/eurovdc-mcp
cd /opt/eurovdc-mcp
git clone https://github.com/eurovdceu/eurovdc-mcp .
npm install
npm run build

Попълнете променливите от README в .env. Никога не комитвайте секрети.

3. Дръжте процеса жив със systemd

sudo tee /etc/systemd/system/eurovdc-mcp.service > /dev/null <<'EOF'
[Unit]
Description=EuroVDC MCP server
After=network.target

[Service]
Type=simple
User=www-data
WorkingDirectory=/opt/eurovdc-mcp
EnvironmentFile=/opt/eurovdc-mcp/.env
ExecStart=/usr/bin/node dist/index.js
Restart=on-failure
RestartSec=5

[Install]
WantedBy=multi-user.target
EOF

sudo systemctl daemon-reload
sudo systemctl enable --now eurovdc-mcp
sudo systemctl status eurovdc-mcp --no-pager

4. Добавете TLS reverse proxy

Клиентите обикновено очакват https://vashiyat-domen.com/mcp. Пример за Nginx и Certbot:

server {
    listen 80;
    server_name mcp.vashiyat-domen.com;

    location / {
        proxy_pass http://127.0.0.1:3100;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_buffering off;
    }
}

sudo certbot --nginx -d mcp.vashiyat-domen.com

Насочете DNS A записа към Sofia VPS IP. За локална работа stdio е достатъчно; за продакшън предпочитайте HTTPS.

5. Свържете Claude или Cursor

За streamable HTTP задайте MCP URL https://mcp.vashiyat-domen.com/mcp и проверете списъка с инструменти.

6. Проверете латентността със Sofia Looking Glass

Измерете RTT за европейски потребители чрез Sofia Looking Glass.

Проверете готовността

След старт пуснете AI готовност върху хоста. Вижте и За AI агенти.

Често задавани въпроси

Нужен ли е tunnel продукт?

Не. TLS reverse proxy на вашия VPS е достатъчен. Локално stdio също работи.

Какъв е минималният размер на сървъра?

Малък Sofia cloud план стига за един MCP процес. Увеличете vCPU и RAM при повече трафик.

Каква е разликата с публичния /mcp?

Публичният endpoint е управляван от EuroVDC. Self-hosting дава пълен контрол върху домейн, логове и капацитет.

Задължителен ли е systemd?

Не, но е препоръчителен. PM2 или Docker също са приемливи.

Защо Claude не се свързва?

Проверете DNS, сертификат, firewall 80/443 и порта на приложението. Логовете на systemd и Nginx обикновено показват проблема.

Защо MCP редът в AI readiness е червен?

Липсва манифест или initialize. Публикувайте /.well-known/mcp.json и потвърдете успешен HTTPS initialize.