Μετάβαση στο κύριο περιεχόμενο
Ελληνικά— Επιλέξτε γλώσσα
Μενού

Διαμόρφωση ενός Απομακρυσμένου Διακομιστή SSE

Μάθημα 7 / 14 Ενημερώθηκε 3 Νοεμβρίου 2026 Για developers
Σε αυτήν τη σελίδα
  1. Μετάβαση από Τοπικό σε Απομακρυσμένο
  2. Ο Διακομιστής Μόλις που Αλλάζει
  3. Απόκτηση Δημόσιου URL με το ngrok
  4. Σύνδεση ενός Πελάτη Python
  5. Πολλαπλοί Διακομιστές σε έναν Μοναδικό Host
  6. Βασικά σημεία

Ενημέρωση 2 Νοεμβρίου 2026 — Το Le Chat είναι πλέον Vibe. Από τις 28 Μαΐου 2026, το Le Chat μετονομάστηκε σε Vibe (παραμένει στο chat.mistral.ai): ένας ενιαίος πράκτορας για εργασία και κώδικα, που διατηρεί τις συνομιλίες, τις ρυθμίσεις και τις συνδρομές σας. Η παλιά εμπειρία του Le Chat παραμένει διαθέσιμη στη λειτουργία Chat· στη λειτουργία Work, οι πράκτορες είναι πλέον δεξιότητες (καλούνται με @), οι μνήμες λειτουργούν ως βάση γνώσεων και η βαθιά αναζήτηση είναι η δεξιότητα Deep Research. Τα πακέτα ονομάζονται πλέον Mistral Free, Pro, Team και Enterprise. Αυτό το μάθημα χρησιμοποιεί την ονομασία Vibe· ορισμένα μενού που περιγράφονται εδώ ενδέχεται να έχουν αλλάξει ονόματα ή τοποθεσίες. Προσθήκη 3 Νοεμβρίου: Τα αποτελέσματα του run_async διαβάζονται από το result.output_as_text· το SDK mistralai 3.7.0 δεν διαθέτει χαρακτηριστικό output.

Ενημέρωση 2 Νοεμβρίου 2026 — MCP Python SDK v2. Αυτό το μάθημα ακολουθεί πλέον την έκδοση 2 του SDK mcp (2.3.0 στις 2 Οκτωβρίου 2026): το MCPServer αντικαθιστά το FastMCP, οι ρυθμίσεις μεταφοράς μεταφέρονται στο run() ή στο streamable_http_app(), και μια εφαρμογή που εκτίθεται υπό πραγματικό όνομα host πρέπει να δηλώνει αυτό το όνομα host (transport_security). Αυτή είναι επίσης η έκδοση που απαιτείται από το Mistral SDK: το πρόσθετο mistralai[agents] απαιτεί mcp>=2.2.0,<3.0. Πηγές: Τι νέο υπάρχει στο v2 · Οδηγός Μετάβασης · Ανάπτυξη και κλιμάκωση.

Μετάβαση από Τοπικό σε Απομακρυσμένο

Μέχρι τώρα, ο διακομιστής MCP σας λειτουργούσε στον υπολογιστή σας, επικοινωνώντας μέσω STDIO. Αυτή η λειτουργία είναι ιδανική για ανάπτυξη, αλλά απομονώνει την εργασία σας: κανείς άλλος δεν μπορεί να τη χρησιμοποιήσει και το Vibe της Mistral δεν μπορεί ποτέ να εκκινήσει μια διαδικασία στον τοπικό σας υπολογιστή. Για να ξεπεράσετε αυτό το όριο, πρέπει να εκθέσετε τον διακομιστή μέσω HTTP.

Η αλλαγή είναι ελαφρύτερη από ό,τι ίσως νομίζετε. Ένας απομακρυσμένος διακομιστής MCP δημοσιεύει τα εργαλεία του σε ένα URL· ο πελάτης—το Vibe, ένα SDK ή ένα IDE—συνδέεται μέσω δικτύου αντί να εκκινεί μια διαδικασία. Ο κώδικας των εργαλείων σας παραμένει αμετάβλητος.

Ο Διακομιστής Μόλις που Αλλάζει

Το MCPServer υποστηρίζει εγγενώς τη μεταφορά Streamable HTTP. Το αρχείο παρακάτω γράφεται ακριβώς όπως ένας τοπικός διακομιστής: ίδιοι διακοσμητές, ίδια docstrings, ίδιες τυποποιημένες υπογραφές.

# remote_server.py
"""Remote MCP server with HTTP transport."""

from mcp.server.mcpserver import MCPServer

# The server is the same as local
app = MCPServer("Remote Demo Server")

@app.tool()
def analyze_text(text: str, language: str = "fr") -> str:
    """Analyze text and return statistics.

    Args:
        text: The text to analyze
        language: Language code (fr, en, es). Default: fr

    Returns:
        Text statistics: word count, character count, sentence count
    """
    words = len(text.split())
    chars = len(text)
    sentences = text.count(".") + text.count("!") + text.count("?")
    return (
        f"Language: {language}\n"
        f"Words: {words}\n"
        f"Characters: {chars}\n"
        f"Sentences: {sentences}"
    )

@app.tool()
def summarize_key_points(text: str, max_points: int = 5) -> str:
    """Extract key points from text (simplified version).

    Args:
        text: The source text
        max_points: Maximum number of points to extract (1-10)

    Returns:
        List of identified key points
    """
    sentences = [s.strip() for s in text.split(".") if len(s.strip()) > 20]
    points = sentences[:max_points]
    return "\n".join(f"- {p}" for p in points) if points else "No key points identified."

Η μόνη αλλαγή είναι ένα μπλοκ εκκίνησης που προστίθεται στο τέλος του αρχείου: μεταφορά HTTP, θύρα και η λίστα των ονομάτων host που δέχεται ο διακομιστής.

import os
from mcp.server.transport_security import TransportSecuritySettings

if __name__ == "__main__":
    # Public hostname, e.g., the one ngrok assigns you (without https://)
    public_host = os.environ.get("MCP_PUBLIC_HOST")
    hosts = ["localhost:*", "127.0.0.1:*"]
    if public_host:
        hosts += [public_host, f"{public_host}:*"]
    app.run(
        transport="streamable-http",
        port=8000,
        transport_security=TransportSecuritySettings(allowed_hosts=hosts),
    )
python remote_server.py

Ο διακομιστής σας ακούει πλέον στο http://localhost:8000/mcp. Η λίστα allowed_hosts δεν είναι λεπτομέρεια: από προεπιλογή, το SDK v2 δέχεται μόνο αιτήσεις που απευθύνονται στο localhost ή στο 127.0.0.1, ως προστασία έναντι του DNS rebinding. Πίσω από μια σήραγγα ή ένα πραγματικό όνομα domain, οποιαδήποτε άλλη αίτηση λαμβάνει σφάλμα 421 Invalid Host header, το οποίο ο πελάτης εμφανίζει ως γενικό σφάλμα μεταφοράς· μόνο το αρχείο καταγραφής του διακομιστή αποκαλύπτει τον λόγο.

Απόκτηση Δημόσιου URL με το ngrok

Για να δοκιμάσετε τον διακομιστή σας από το Vibe χωρίς πλήρη ανάπτυξη, το ngrok δημιουργεί μια σήραγγα μεταξύ ενός δημόσιου URL και της τοπικής σας θύρας. Αυτό το εργαλείο συντομεύει τον κύκλο ανάπτυξης περισσότερο από οτιδήποτε άλλο: τροποποιείτε ένα εργαλείο, κάνετε επανεκκίνηση και ο απομακρυσμένος συνδέκτης βλέπει αμέσως τη νέα έκδοση.

# Install the ngrok agent from https://ngrok.com/download, then authenticate (once)
ngrok config add-authtoken YOUR_NGROK_TOKEN

# Expose port 8000
ngrok http 8000

Το ngrok σας εκχωρεί μια διεύθυνση όπως https://abc123.ngrok-free.app. Κάντε επανεκκίνηση του διακομιστή δηλώνοντας αυτό το όνομα host (MCP_PUBLIC_HOST=abc123.ngrok-free.app python remote_server.py). Το σημείο τελικού προορισμού (endpoint) του MCP σας γίνεται αυτό, απλώς προσθέτοντας τη διαδρομή /mcp:

https://abc123.ngrok-free.app/mcp

Προσθέστε αυτό το URL ως έχει στο Mistral Vibe ως προσαρμοσμένο συνδέκτη. Θυμηθείτε ότι είναι προσωρινό και εκθέτει τον υπολογιστή σας: μην αφήνετε μια σήραγγα ανοιχτή σε έναν διακομιστή που αγγίζει πραγματικά δεδομένα.

Σύνδεση ενός Πελάτη Python

Στην πλευρά του πελάτη, η δομή του κώδικα παραμένει ίδια με αυτή του μαθήματος RunContext. Διαφέρει μόνο η κλάση σύνδεσης: το MCPClientStreamableHTTP με το StreamableHTTPServerParams αντικαθιστά το ζεύγος STDIO και παρέχετε ένα URL αντί για μια εντολή.

# remote_client.py
import asyncio
from mistralai.client import Mistral
from mistralai.extra.run.context import RunContext
from mistralai.extra.mcp.streamable_http import (
    MCPClientStreamableHTTP,
    StreamableHTTPServerParams,
)

async def main():
    client = Mistral(api_key="YOUR_API_KEY")

    agent = client.beta.agents.create(
        model="mistral-medium-latest",
        name="remote-assistant",
        instructions="You use remote tools to analyze text.",
    )

    # Connect to the remote server
    server_url = "https://abc123.ngrok-free.app/mcp"
    mcp_client = MCPClientStreamableHTTP(
        params=StreamableHTTPServerParams(
            url=server_url,
            timeout=100,  # Timeout in seconds
        )
    )

    async with RunContext(
        agent_id=agent.id,
        continue_on_fn_error=True,
    ) as run_ctx:
        await run_ctx.register_mcp_client(mcp_client=mcp_client)

        result = await client.beta.conversations.run_async(
            run_ctx=run_ctx,
            inputs="Analyze this text: MCP is an open protocol.",
        )
        print(result.output_as_text)

asyncio.run(main())

Η παράμετρος timeout αξίζει μια στιγμή σκέψης. Μέσω STDIO, οι κλήσεις ήταν σχεδόν ακαριαίες· μέσω δικτύου, ένα εργαλείο που κάνει ερώτημα σε API τρίτου μέρους ή επεξεργάζεται ένα μεγάλο έγγραφο μπορεί να πάρει αρκετά δευτερόλεπτα. Ένα πολύ μικρό χρονικό όριο εκδηλώνεται ως διαλείποντα, δύσκολα αναπαραγώγιμα σφάλματα, συνήθως στα πιο χρήσιμα αιτήματα.

Όταν ο διακομιστής αναμένει συγκεκριμένες κεφαλίδες—ένα διακριτικό API, ένα κλειδί δρομολόγησης, έναν περιορισμό CORS—τις περνάτε στις headers:

mcp_client = MCPClientStreamableHTTP(
    params=StreamableHTTPServerParams(
        url="https://my-server.example.com/mcp",
        timeout=100,
        headers={
            "Authorization": "Bearer my_api_token",
            "X-Custom-Header": "value",
        },
    )
)

Πολλαπλοί Διακομιστές σε έναν Μοναδικό Host

Το Μάθημα 3 συνέστησε εστιασμένους διακομιστές αντί για έναν γενικό κατάλογο. Αυτή η σύσταση δεν σας καταδικάζει να νοικιάζετε ένα μηχάνημα ανά διακομιστή: με το FastAPI, μπορείτε να προσαρτήσετε πολλαπλούς διακομιστές MCP σε διακριτές διαδρομές του ίδιου host.

# server.py — Multiple MCP servers on a single host
from contextlib import asynccontextmanager

from fastapi import FastAPI
from mcp.server.mcpserver import MCPServer
from mcp.server.transport_security import TransportSecuritySettings

# MCP server for text analysis
text_mcp = MCPServer("Text Analysis")

@text_mcp.tool()
def analyze(text: str) -> str:
    """Analyze text."""
    return f"Words: {len(text.split())}"

# MCP server for calculations
math_mcp = MCPServer("Math Tools")

@math_mcp.tool()
def calculate(expression: str) -> str:
    """Evaluate a mathematical expression."""
    return str(eval(expression))  # Warning: eval in production!

# Each MCP server produces a standalone ASGI app,
# which must know the hostname under which it is served
security = TransportSecuritySettings(allowed_hosts=["mon-serveur.com", "mon-serveur.com:*"])
text_app = text_mcp.streamable_http_app(transport_security=security)
math_app = math_mcp.streamable_http_app(transport_security=security)

# Combined lifespan: each server must start its session manager
@asynccontextmanager
async def lifespan(app: FastAPI):
    async with text_mcp.session_manager.run(), math_mcp.session_manager.run():
        yield

api = FastAPI(lifespan=lifespan)
api.mount("/text", text_app)
api.mount("/math", math_app)

Λαμβάνετε δύο ανεξάρτητα σημεία τελικού προορισμού, το https://mon-serveur.com/text/mcp για εργαλεία ανάλυσης κειμένου και το https://mon-serveur.com/math/mcp για μαθηματικά εργαλεία, τα οποία προσθέτετε ξεχωριστά στο Vibe. Το κρίσιμο σημείο είναι το lifespan: κάθε διακομιστής MCP έχει έναν διαχειριστή συνεδρίας που πρέπει να εκκινείται ρητά. Αν προσαρτήσετε τις εφαρμογές χωρίς να περάσετε αυτό το lifespan στο FastAPI, ο διακομιστής αποκρίνεται, αλλά κάθε κλήση εργαλείου αποτυγχάνει με σφάλμα μη αρχικοποιημένης εργασίας. Ένας χρήστης που χρειάζεται μόνο υπολογισμούς δεν θα επιβαρύνει το πλαίσιο του με εργαλεία κειμένου. Το σχόλιο για το eval δεν είναι αστείο: σε ένα δημόσιο σημείο τελικού προορισμού, αυτή η γραμμή εκτελεί οποιονδήποτε κώδικα σταλεί από τον καλούντα—είναι ένα παιδαγωγικό παράδειγμα, ποτέ ένα μοτίβο παραγωγής.

Μια τελευταία συνήθεια: πριν προσθέσετε το URL σας σε μια συνομιλία, περάστε το ξανά από τον Επιθεωρητή (Inspector). Ένα απομακρυσμένο σημείο τελικού προορισμού προσθέτει πηγές αστοχίας που ο τοπικός αγνοούσε—κλειστή σήραγγα, missing header, κατειλημμένη θύρα—και είναι καλύτερο να τις ανακαλύψετε εκτός μιας συνομιλίας.

Βασικά σημεία

  • Ένας απομακρυσμένος διακομιστής MCP εκθέτει τα εργαλεία του μέσω HTTP σε ένα σημείο τελικού προορισμού /mcp
  • Το ngrok σας επιτρέπει να αποκτήσετε ένα δημόσιο URL για ανάπτυξη
  • Το MCPClientStreamableHTTP με το StreamableHTTPServerParams συνδέει τον πελάτη με τον απομακρυσμένο διακομιστή (το MCPClientSSE είναι πλέον μόνο για παλιά σημεία τελικού προορισμού /sse)
  • Η παράμετρος timeout είναι σημαντική για αργούς διακομιστές
  • Μπορείτε να προσαρτήσετε πολλαπλούς διακομιστές MCP στον ίδιο host FastAPI, υπό την προϋπόθεση ότι θα περάσετε το lifespan τους
  • Δοκιμάζετε πάντα με τον Inspector πριν την ενσωμάτωση σε μια συνομιλία