Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Ikkonfigura Server MCP Lokali (STDIO)

Lezzjoni 4 / 14 Aġġornat 2 ta’ Novembru 2026 Zviluppatur
F'din il-paġna
  1. L-ewwel server MCP lokali tiegħek
  2. Niktbu s-server
  3. Nikkonfiguraw il-klijent STDIO
  4. Ittestja qabel tintegra
  5. Punti Ewlenin

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): MCPServer tissostitwixxi FastMCP, is-settings tat-trasport jiċċaqalqu lejn run() jew streamable_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-extra mistralai[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
  • StdioServerParameters tikkonfigura 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=None jiret l-ambjent kollu; dict espliċitu jillimita l-varjabbli