Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Konfigurácia lokálneho MCP servera (STDIO)

Lekcia 4 z 14 Aktualizované 2. novembra 2026 Vývojár
Na tejto strane
  1. Tvoj prvý lokálny MCP server
  2. Napísanie servera
  3. Konfigurácia STDIO klienta
  4. Testovanie pred integráciou
  5. Kľúčové poznatky

Aktualizované 2. novembra 2026 — MCP Python SDK v2. Tento kurz teraz nasleduje verziu 2 SDK mcp (2.3.0 k 2. októbru 2026): MCPServer nahrádza FastMCP, nastavenia transportu sa presúvajú do run() alebo streamable_http_app() a aplikácia vystavená pod skutočným hostname musí tento hostname deklarovať (transport_security). Toto je tiež verzia požadovaná Mistral SDK: extra balík mistralai[agents] vyžaduje mcp>=2.2.0,<3.0. Zdroje: Čo je nové vo v2 · Sprievodca migráciou · Nasadenie a škálovanie.

Tvoj prvý lokálny MCP server

Režim STDIO je prirodzeným východiskovým bodom pre vývoj a testovanie MCP servera: všetko beží na tvojom stroji, bez nasadzovania, verejnej URL alebo potreby spravovať certifikáty. Upravíš súbor, reštartuješ a pozoruješ. V tejto lekcii napíšeš lokálny MCP server v Pythone a následne ho pripojíš ku klientovi.

Pokiaľ ide o predpoklady, potrebuješ Python 3.10 alebo vyšší, aktuálny pip a ideálne vyhradené virtuálne prostredie. Posledný bod nie je len kozmetický: balíky MCP sa rýchlo vyvíjajú a samostatné virtuálne prostredie pre každý projekt ti zabráni rozbiť funkčný server pri inštalácii závislosti pre iný projekt.

# Vytvorenie virtuálneho prostredia
python -m venv mcp-env
source mcp-env/bin/activate  # Linux/Mac
# mcp-env\Scripts\activate   # Windows

# Oficiálne MCP SDK (v2) a Mistral SDK s extra balíkom agents
pip install "mcp[cli]>=2.2,<3" "mistralai[agents]"

Napísanie servera

Pomocou MCPServer, vysokoúrovňovej triedy v oficiálnom SDK (predtým FastMCP), zaberie lokálny server len niekoľko riadkov. Inicializuješ aplikáciu pridaním popisného názvu a následne ozdobíš svoje Python funkcie dekorátorom @app.tool(), aby si ich vystavil.

# serveur_local.py
from mcp.server.mcpserver import MCPServer

# Inicializácia servera s popisným názvom
app = MCPServer("Local Demo Server")

@app.tool()
def greet(name: str) -> str:
    """Pozdraví osobu podľa mena.

    Args:
        name: Krstné meno osoby, ktorú treba pozdraviť

    Returns:
        Personalizovaná pozdravná správa
    """
    return f"Hello {name}! Welcome to the world of MCP."

@app.tool()
def calculate(operation: str, a: float, b: float) -> str:
    """Vykoná jednoduchý matematický výpočet.

    Args:
        operation: Operácia, ktorú treba vykonať (add, sub, mul, div)
        a: Prvé číslo
        b: Druhé číslo

    Returns:
        Výsledok výpočtu
    """
    ops = {
        "add": a + b,
        "sub": a - b,
        "mul": a * b,
        "div": a / b if b != 0 else "Error: division by zero"
    }
    result = ops.get(operation, "Unknown operation")
    return f"{a} {operation} {b} = {result}"

Tento súbor vystavuje dva nástroje. Všimni si úlohu docstringov: nielenže dokumentujú tvoj kód pre kolegu, ale doslova sa stávajú popisom, ktorý model číta, aby sa rozhodol, či zavolať calculate namiesto greet. Nedbalý docstring tu vedie k erratickým volaniam neskôr.

Konfigurácia STDIO klienta

Na strane klienta sa nepripájaš na adresu; vysvetľuješ, ako server spustiť. To je úlohou StdioServerParameters.

# client_stdio.py
from mcp import StdioServerParameters
from mistralai.extra.mcp.stdio import MCPClientSTDIO
from pathlib import Path

# Cesta k tvojmu serveru
path_to_server = Path("serveur_local.py")

# Konfigurácia STDIO servera
server_params = StdioServerParameters(
    command="python",           # Príkaz na spustenie servera
    args=[str(path_to_server)], # Argumenty (Python súbor)
    env=None,                   # Premenné prostredia (voliteľné)
)

# Vytvorenie MCP klienta
mcp_client = MCPClientSTDIO(stdio_params=server_params)

Tri parametre si zaslúžia podrobnejší pohľad.

command

Toto je systémový príkaz, ktorý spúšťa proces servera: "python" pre Python server, "node" pre JavaScript server alebo priama cesta k binárnemu súboru, ak je tvoj server skompilovaný.

# Python
command="python"

# Node.js
command="node"

# Skompilovaný executable
command="./mon_serveur_mcp"

args

Toto je zoznam argumentov odovzdaných danému príkazu. Pre Python skript je to minimálne cesta k súboru, ale nič ti nebráni odovzdať tu aj možnosti tvojho servera.

# Jednoduchý skript
args=["serveur_local.py"]

# S dodatočnými argumentmi
args=["serveur_local.py", "--port", "8080", "--verbose"]

env

Toto je slovník premenných prostredia odovzdaných procesu servera: kanál, ktorým mu odovzdáš API kľúč, URL databázy alebo ladiaci flag.

import os

server_params = StdioServerParameters(
    command="python",
    args=["serveur_local.py"],
    env={
        **os.environ,  # Dedičstvo z aktuálneho prostredia
        "API_KEY": "your_api_key",
        "DATABASE_URL": "postgresql://...",
        "DEBUG": "true",
    },
)

Správanie tohto parametra ľudí často prekvapí. Pri env=None server dedí celé prostredie nadradeného procesu; pri slovníku vidí striktne len uvedené premenné. Ak poskytneš slovník bez vliatia os.environ, nebuď prekvapený, ak tvoj server už nenájde svoj PATH alebo tvoj API kľúč: správanie je úplne logické, jednoducho radikálne.

Testovanie pred integráciou

Pred pripojením servera k agentovi ho otestuj v izolácii pomocou MCP Inspector. Logika je jednoduchá: ak volanie zlyhá po pripojení servera k modelu, nebudeš vedieť, či problém leží v tvojom kóde alebo v rozhodnutí modelu. Inspector túto nejednoznačnosť odstraňuje.

npx @modelcontextprotocol/inspector python serveur_local.py

Príkaz otvorí lokálne webové rozhranie, kde môžeš vypísať vystavené nástroje, skontrolovať popis a parametre, ktoré model dostane, spustiť manuálne volanie s argumentmi podľa vlastného výberu a overiť presný formát návratovej hodnoty. Urob si zvyk používať to systematicky: je to päť minút, ktoré ušetria hodinu.

Nakoniec, tu je organizácia súborov, ktorá dobre starne, so serverom, klientom, závislosťami, tajomstvami mimo repozitára a unit testami pre tvoje nástroje:

mon-projet-mcp/
├── serveur_local.py     # MCP server
├── client_stdio.py      # Skript klienta
├── requirements.txt     # Závislosti
├── .env                 # Premenné prostredia (nikdy necommitovať)
└── tests/
    └── test_tools.py    # Unit testy pre nástroje

Kľúčové poznatky

  • STDIO server sa spúšťa ako lokálny proces
  • StdioServerParameters konfiguruje príkaz, argumenty a premenné prostredia
  • Docstringy tvojich nástrojov slúžia ako popis pre model
  • MCP Inspector (npx @modelcontextprotocol/inspector) je nevyhnutný pre testovanie
  • env=None dedí celé prostredie; explicitný slovník obmedzuje premenné