Konfigurácia lokálneho MCP servera (STDIO)
Na tejto strane
Aktualizované 2. novembra 2026 — MCP Python SDK v2. Tento kurz teraz nasleduje verziu 2 SDK
mcp(2.3.0 k 2. októbru 2026):MCPServernahrádzaFastMCP, nastavenia transportu sa presúvajú dorun()alebostreamable_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íkmistralai[agents]vyžadujemcp>=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
StdioServerParameterskonfiguruje 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=Nonededí celé prostredie; explicitný slovník obmedzuje premenné