Разполагане на MCP сървър в продукционна среда
На тази страница
Актуализация от 2 ноември 2026 г. — Le Chat вече е Vibe. От 28 май 2026 г. Le Chat беше ребрандиран като Vibe (все още на chat.mistral.ai): единен агент за работа и код, който запазва Вашите разговори, настройки и абонаменти. Legacy изживяването на Le Chat остава достъпно в режим Chat; в режим Work, агентите вече са умения (извикват се с
@, спомените формират базата знания, а дълбокото проучване е умението Deep Research. Плановете вече се наричат Mistral Free, Pro, Team и Enterprise. Този урок използва името Vibe; някои менюта, описани тук, може да са променили имената или местоположенията си.
Актуализация от 2 ноември 2026 г. — MCP Python SDK v2. Този курс следва версия 2 на
mcpSDK (2.3.0 към 2 октомври 2026 г.):MCPServerзаместваFastMCP, настройките за транспорт се преместват вrun()илиstreamable_http_app(), а приложение, изложено под реално име на хост, трябва да декларира това име на хост (transport_security). Това е също версията, изисквана от Mistral SDK: екстратаmistralai[agents]изискваmcp>=2.2.0,<3.0. Източници: Какво е ново във v2 · Ръководство за миграция · Разполагане и мащабиране.
От прототип до продукционен сървър
Вашият сървър работи локално, а ngrok го излага на света само за демонстрация. Проблемът започва, когато някой друг трябва да го използва: затваряте терминала си, URL адресът изчезва и всеки конектор, който колегите Ви са конфигурирали, се поврежда. Преминаването към продукционна среда по същество означава получаване на стабилен адрес, наличен 24/7, обслужван през HTTPS. Четири опции Ви водят дотам, вариращи от най-бързата до най-контролираната. Вашият избор зависи основно от това колко чувствителни са Вашите данни и колко контрол искате да имате над инфраструктурата.
Опция 1: Hugging Face Spaces
Hugging Face Spaces предоставя безплатни виртуални машини без GPU, които са повече от достатъчни за MCP сървър, който препраща API повиквания. Това е най-бързият път до реално разполагане: три файла и едно git push.
mon-mcp-space/
├── app.py # FastAPI + MCP сървър
├── requirements.txt # Зависимости
└── README.md # Метаданни на Space
Файлът app.py следва точната структура, която видяхте досега, с изключение на това, че чувствителните стойности се четат от околната среда — HF Secrets ги инжектират там:
# app.py
"""MCP сървър, разположен на Hugging Face Spaces."""
import os
from contextlib import asynccontextmanager
from fastapi import FastAPI
from mcp.server.mcpserver import MCPServer
from mcp.server.transport_security import TransportSecuritySettings
mcp = MCPServer("My Production Server")
@mcp.tool()
def hello(name: str) -> str:
"""Поздравяване на човек.
Args:
name: Първото име на човека
Returns:
Поздравително съобщение
"""
return f"Hello {name} from Hugging Face Spaces!"
@asynccontextmanager
async def lifespan(app: FastAPI):
async with mcp.session_manager.run():
yield
# Име на хост на Space, във формата <user>-<space>.hf.space
SPACE_HOST = os.environ.get("MCP_PUBLIC_HOST", "localhost")
security = TransportSecuritySettings(allowed_hosts=[SPACE_HOST, f"{SPACE_HOST}:*"])
api = FastAPI(lifespan=lifespan)
api.mount("/mcp-endpoint", mcp.streamable_http_app(transport_security=security))
# За чувствителни променливи използвайте HF Secrets
API_KEY = os.environ.get("MY_API_KEY", "")
Спецификата на платформата се крие в README файла, чийто YAML хедър управлява изграждането на Space. Полето app_port трябва да съвпада с порта, на който сървърът Ви всъщност слуша; в противен случай разполагането успява, но остава недостъпно:
---
title: My MCP Server
emoji: 🔧
colorFrom: blue
colorTo: green
sdk: docker
app_port: 7860
---
# Създаване на Space на huggingface.co
# Качване на кода
git push
# Space се разполага автоматично
Вашият крайна точка тогава става https://your-username-mon-mcp-space.hf.space/mcp-endpoint/mcp, обслужвана през HTTPS. Остава една стъпка за конфигуриране: декларирайте това име на хост, your-username-mon-mcp-space.hf.space, в променливата MCP_PUBLIC_HOST в настройките на Space. Без него SDK ще отхвърли всяка заявка с грешка 421 Invalid Host header.
Опция 2: Docker
Веднага щом сървърът докосне вътрешни данни, хостването на Ваша собствена инфраструктура става правило, а Docker е стандартният формат. Dockerfile изисква само няколко инструкции, като инсталирането на зависимостите се поставя преди копирането на кода, за да се използва кеширането на слоеве при повторни изграждания:
FROM python:3.12-slim
WORKDIR /app
# Инсталиране на зависимости
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt
# Копиране на код
COPY . .
# Излагане на порт
EXPOSE 8000
# Стартиране на сървъра
CMD ["uvicorn", "server:api", "--host", "0.0.0.0", "--port", "8000"]
fastapi>=0.115.0
uvicorn>=0.30.0
mcp>=2.2,<3
httpx>=0.27.0 # само ако Вашите инструменти го използват: SDK v2 вече не го инсталира
При стартиране опцията --restart unless-stopped е това, което отличава продукционното разполагане от обикновен тест: без нея първият срив ще извади сървъра Ви от строя, докато някой не забележи.
# Изграждане на образа
docker build -t mon-mcp-server .
# Стартиране на контейнера
docker run -d \
--name mcp-server \
-p 8000:8000 \
-e MY_API_KEY="secret" \
-e DATABASE_URL="postgresql://..." \
--restart unless-stopped \
mon-mcp-server
Docker Compose прави тази конфигурация възпроизводима и добавя проверка на здравето (health check), която оркестраторът използва за откриване на замръзнал сървър — жив процес, който вече не отговаря, е сценарий, който простите автоматични рестарти не покриват:
# docker-compose.yml
version: "3.8"
services:
mcp-server:
build: .
ports:
- "8000:8000"
environment:
- MY_API_KEY=${MY_API_KEY}
- DATABASE_URL=${DATABASE_URL}
restart: unless-stopped
healthcheck:
test: ["CMD", "curl", "-f", "http://localhost:8000/"]
interval: 30s
retries: 3
Опции 3 и 4: Управлявани разполагания
Prefect Horizon (предишно име FastMCP Cloud), платформата от екипа зад независимия фреймуърк FastMCP, премахва стъпката с инфраструктурата: влизате в horizon.prefect.io с Вашия GitHub акаунт, избирате хранилището и файла на сървъра, а платформата изгражда и публикува URL с вградена автентикация. Тя е насочена към сървъри, написани с този фреймуърк (pip install fastmcp, from fastmcp import FastMCP), който е различен от официалния SDK, използван в този курс; съществува безплатен план за лични проекти.
Cloudflare Workers е насочен към различен профил на употреба: serverless, с изпълнение най-близо до потребителя и следователно намалена латентност. Специализиран шаблон стартира проекта:
# Използване на MCP шаблона на Cloudflare
npm create cloudflare@latest -- remote-mcp-server-authless --template=cloudflare/ai/demos/remote-mcp-authless
И двете опции Ви спестяват управлението на сертификати и рестарти, за сметка на зависимост от платформата и ограничения при изпълнението — например, serverless Worker не си пасва добре със сървър, поддържащ състояние (stateful).
Осигуряване на разполагането
HTTPS е задължително: Vibe отказва крайни точки в plain text, а токен, пътуващ по HTTP, е компрометиран токен. Три пътя водят дотам в зависимост от Вашия хостинг. Обърнат прокси (reverse proxy) като Nginx или Caddy, поставен пред Вашия сървър със сертификат от Let’s Encrypt, покрива случая със специализиран сървър. Cloud-native платформи — Hugging Face, Cloudflare и повечето PaaS доставчици — предоставят HTTPS автоматично. Тунел, като Cloudflare Tunnel, излага сървър, оставащ във Вашата вътрешна мрежа, без да отваря портове.
Никаква тайна не трябва да се появява в кода. Отбележете разликата между двата синтаксиса по-долу: os.environ["MCP_API_TOKEN"] причинява неуспех при стартиране, ако променливата липсва, което е точно желаното поведение за задължителна тайна, докато os.environ.get() толерира липсата за незадължителни стойности.
import os
# Конфигурация чрез променливи на околната среда
API_TOKEN = os.environ["MCP_API_TOKEN"] # Задължително
DATABASE_URL = os.environ.get("DATABASE_URL") # Незадължително
DEBUG = os.environ.get("DEBUG", "false") == "true"
Публичен сървър без ограничаване на честотата (rate limiting) рано или късно се насища, умишлено или не. Ограничител, базиран на IP адрес, е достатъчен в повечето случаи:
from fastapi import FastAPI, Request
from slowapi import Limiter, _rate_limit_exceeded_handler
limiter = Limiter(key_func=lambda request: request.client.host)
api = FastAPI()
api.state.limiter = limiter
@api.middleware("http")
async def rate_limit(request: Request, call_next):
# 100 заявки в минута на IP адрес
...
Наблюдение на случващото се
В продукционна среда вече нямате терминала пред себе си и инструмент, който се проваля един път на десет, може да бъде диагностициран само чрез следи (traces). Като минимум инструментирайте входа, изхода и продължителността на всяко повикване:
import logging
import time
logger = logging.getLogger("mcp-server")
@mcp.tool()
async def my_tool(param: str) -> str:
"""Моят инструмент с логове."""
start = time.time()
logger.info(f"Tool called with param={param}")
try:
result = await process(param)
duration = time.time() - start
logger.info(f"Tool finished in {duration:.2f}s")
return result
except Exception as e:
logger.error(f"Error in tool: {e}")
raise
Измерването на продължителността не е лукс: инструмент, който отнема дванадесет секунди да отговори, предизвиква таймаути на страната на клиента и създава впечатлението за счупен сървър, когато всъщност работи. Преди да обявите Вашия сървър, прегледайте следните шест точки за конфигурация.
- HTTPS активен и валиден сертификат
- Променливи на околната среда за всички тайни
- Активирано структурирано логиране
- Крайна точка за проверка на здравето (
/или/health) - Автоматичен рестарт при срив
- Конфигурирано ограничаване на честотата
Остават две проверки, тези, които хората най-често пропускат, но които разкриват истинските проблеми: тест с MCP Inspector, стартиран отвън, след това тест от Mistral Vibe. Сървър, който отговаря перфектно от Вашата машина, може да бъде блокиран от защитна стена или CORS конфигурация веднага щом бъде извикан от другаде.
Ключови изводи
- Hugging Face Spaces: най-бързо, безплатно, идеално за начало
- Docker: пълен контрол, подходящо за специализирани сървъри и облак
- Prefect Horizon (бивш FastMCP Cloud): разполагане от GitHub, за сървъри, написани с фреймуърка FastMCP
- Cloudflare Workers: serverless, ниска латентност, мащабируемост
- Осигурете с HTTPS, променливи на околната среда и ограничаване на честотата
- Добавете мониторинг и логове за дебъгване в продукционна среда