Ikkonfigura Server MCP Lokali (STDIO)
F'din il-paġna
Aġġornat fit-2 ta’ Novembru, 2026 — MCP Python SDK v2. Dan il-kors issa jsegwi l-verżjoni 2 tal-SDK
mcp(2.3.0 sal-2 ta’ Ottubru, 2026):MCPServertissostitwixxiFastMCP, is-settings tat-trasport jiċċaqalqu lejnrun()jewstreamable_http_app(), u applikazzjoni esposta taħt hostname reali trid tiddikjara dak l-hostname (transport_security). Din hija wkoll il-verżjoni meħtieġa mill-Mistral SDK: l-extramistralai[agents]jeħtieġmcp>=2.2.0,<3.0. Sorsi: X’inhu ġdid f’v2 · Gwida għall-Migrazzjoni · Iddispjega u skala.
L-ewwel server MCP lokali tiegħek
Il-modalità STDIO hija l-punt tat-tluq naturali biex tiżviluppa u tittestja server MCP: kollox jaħdem fuq il-magna tiegħek, mingħajr dispjegament, mingħajr URL pubbliku, u mingħajr ċertifikati biex timmaniġġja. Teditja fajl, terġa’ tistartja, u tosserva. F’din il-lezzjoni, se tikteb server MCP lokali f’Python u mbagħad tikkonnettjah ma’ klijent.
Bħala prerekwiżiti, għandek bżonn Python 3.10 jew ogħla, pip aġġornat, u preferibbilment ambjent virtwali ddedikat. Dan l-aħħar punt mhuwiex kożmetiku: il-pakketti MCP jevolvu malajr, u venv separat għal kull proġett jipprevjenik milli tkisser server li jaħdem meta tinstalla dipendenza għal ieħor.
# Oħloq ambjent virtwali
python -m venv mcp-env
source mcp-env/bin/activate # Linux/Mac
# mcp-env\Scripts\activate # Windows
# MCP SDK uffiċjali (v2) u Mistral SDK bl-extra tal-aġenti tiegħu
pip install "mcp[cli]>=2.2,<3" "mistralai[agents]"
Niktbu s-server
B’MCPServer, il-klassi ta’ livell għoli fl-SDK uffiċjali (qabel FastMCP), server lokali jieħu ftit linji biss. Tistanzja applikazzjoni billi tagħtiha isem deskrittiv, imbagħad iddekorja l-funzjonijiet Python tiegħek b’@app.tool() biex tesponihom.
# serveur_local.py
from mcp.server.mcpserver import MCPServer
# Inizjalizza s-server b'isem deskrittiv
app = MCPServer("Local Demo Server")
@app.tool()
def greet(name: str) -> str:
"""Greets a person by name.
Args:
name: The first name of the person to greet
Returns:
A personalized greeting message
"""
return f"Hello {name}! Welcome to the world of MCP."
@app.tool()
def calculate(operation: str, a: float, b: float) -> str:
"""Performs a simple mathematical calculation.
Args:
operation: The operation to perform (add, sub, mul, div)
a: First number
b: Second number
Returns:
The result of the calculation
"""
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}"
Dan il-fajl jesponi żewġ għodod. Innota r-rwol tad-docstrings: mhux biss jiddokumentaw il-kodiċi tiegħek għal kollega; dawn isiru litteralment id-deskrizzjoni li l-mudell jaqra biex jiddeċiedi jekk iħallix calculate minflok greet. Docstring traskurat hawn iwassal għal sejħiet erratici aktar tard.
Nikkonfiguraw il-klijent STDIO
Fuq in-naħa tal-klijent, m’intix tikkonnettja ma’ indirizz; qed tispjega kif tistartja s-server. Dak hu r-rwol ta’ StdioServerParameters.
# client_stdio.py
from mcp import StdioServerParameters
from mistralai.extra.mcp.stdio import MCPClientSTDIO
from pathlib import Path
# Mogħdija lejn is-server tiegħek
path_to_server = Path("serveur_local.py")
# Konfigurazzjoni tas-server STDIO
server_params = StdioServerParameters(
command="python", # Il-kumand biex tniedi s-server
args=[str(path_to_server)], # L-argumenti (il-fajl Python)
env=None, # Varjabbli tal-ambjent (fakultattiv)
)
# Oħloq il-klijent MCP
mcp_client = MCPClientSTDIO(stdio_params=server_params)
Tliet parametri jistħoqqilhom dettall.
command
Dan hu l-kumand tas-sistema li jniedi l-proċess tas-server: "python" għal server Python, "node" għal server JavaScript, jew il-mogħdija diretta għal binarju jekk is-server tiegħek hu kkumpilat.
# Python
command="python"
# Node.js
command="node"
# Eżekuttiv kkumpilat
command="./mon_serveur_mcp"
args
Din hija l-lista ta’ argumenti mgħoddija lil dak il-kumand. Għal skritt Python, dan hu mill-inqas il-mogħdija tal-fajl, iżda xejn ma jwaqqafek milli tgħaddi l-għażliet tas-server tiegħek hawn.
# Skritt sempliċi
args=["serveur_local.py"]
# B'argumenti addizzjonali
args=["serveur_local.py", "--port", "8080", "--verbose"]
env
Dan hu d-dizzjunarju ta’ varjabbli tal-ambjent mgħoddija lill-proċess tas-server: il-kanal li permezz tiegħu tgħaddilu ċavetta API, URL ta’ database, jew flag ta’ debug.
import os
server_params = StdioServerParameters(
command="python",
args=["serveur_local.py"],
env={
**os.environ, # Wirt mill-ambjent attwali
"API_KEY": "your_api_key",
"DATABASE_URL": "postgresql://...",
"DEBUG": "true",
},
)
L-imġiba ta’ dan il-parametru spiss tissorpriża lin-nies. B’env=None, is-server jiret l-ambjent kollu tal-proċess ġenitur; b’dizzjunarju, jara strettament biss il-varjabbli elenkati. Jekk tipprovdi dizzjunarju mingħajr ma tbattal os.environ fih, titstenniex jekk is-server tiegħek ma jkunx jista’ jsib il-PATH tiegħu jew iċ-ċavetta API tiegħek: l-imġiba hija perfettament loġika, sempliċiment radikali.
Ittestja qabel tintegra
Qabel ma tħabbat is-server tiegħek ma’ aġent, ittestjah f’iżolament bl-MCP Inspector. Ir-raġunament hu sempliċi: jekk sejħa tfalli darba li s-server ikun konness ma’ mudell, ma tkunx taf jekk il-problema hijiex fil-kodiċi tiegħek jew fid-deċiżjoni tal-mudell. L-Inspector ineħħi din l-ambigwità.
npx @modelcontextprotocol/inspector python serveur_local.py
Il-kumand jiftaħ interfaċċja web lokali fejn tista’ telenka l-għodod esposti, tispezzjona d-deskrizzjoni u l-parametri li l-mudell se jirċievi, tniedi sejħa manwali b’argumenti tal-għażla tiegħek, u tivverifika l-format eżatt tal-valur tar-ritorn. Agħmilha drawwa li tuża dan sistematikament: huma ħames minuti li jiffrankawlek siegħa.
Fl-aħħar nett, hawnhekk hija organizzazzjoni ta’ fajls li tibqa’ tajba matul iż-żmien, bis-server, il-klijent, id-dipendenzi, is-sigrieti miżmuma barra mir-repożitorju, u testijiet tal-unità għall-għodod tiegħek:
mon-projet-mcp/
├── serveur_local.py # Is-server MCP
├── client_stdio.py # L-iskritt tal-klijent
├── requirements.txt # Id-dipendenzi
├── .env # Varjabbli tal-ambjent (qatt ma jiġu kkomittjati)
└── tests/
└── test_tools.py # Testijiet tal-unità għall-għodod
Punti Ewlenin
- Server STDIO jinxtegħel bħala proċess lokali
StdioServerParameterstikkonfigura l-kumand, l-argumenti, u l-varjabbli tal-ambjent- Id-docstrings tal-għodod tiegħek iservu bħala d-deskrizzjoni għall-mudell
- L-MCP Inspector (
npx @modelcontextprotocol/inspector) hu essenzjali għall-ittestjar env=Nonejiret l-ambjent kollu; dict espliċitu jillimita l-varjabbli