Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

Konfigurēt lokālu MCP serveri (STDIO)

Nodarbība 4 no 14 Atjaunota 2026. gada 2. novembris Programmētājs
Šajā lapā
  1. Tavs pirmais lokālais MCP serveris
  2. Servera rakstīšana
  3. STDIO klienta konfigurēšana
  4. Testē pirms integrācijas
  5. Galvenās atziņas

Atjaunināts 2026. gada 2. novembrī — MCP Python SDK v2. Šis kurss tagad seko mcp SDK 2. versijai (2.3.0 versija, sākot no 2026. gada 2. oktobra): MCPServer aizstāj FastMCP, transporta iestatījumi tiek pārvietoti uz run() vai streamable_http_app(), un lietojumprogrammai, kas eksponēta zem reāla resursdatora nosaukuma, ir jādeklarē šis nosaukums (transport_security). Tā ir arī versija, ko pieprasa Mistral SDK: mistralai[agents] papildinājums prasa mcp>=2.2.0,<3.0. Avoti: Kas jauns v2 · Migrācijas ceļvedis · Izvietošana un mērogošana.

Tavs pirmais lokālais MCP serveris

STDIO režīms ir dabiskais sākumpunkts MCP servera izstrādei un testēšanai: viss darbojas tavā datorā, bez izvietošanas, bez publiskas URL un bez sertifikātu pārvaldības. Tu rediģē failu, restartē un novēro rezultātu. Šajā nodarbībā tu uzrakstīsi lokālu MCP serveri valodā Python un pēc tam to savienosi ar klientu.

Kas attiecas uz priekšnosacījumiem, tev ir nepieciešams Python 3.10 vai jaunāks, atjaunināts pip un vēlams atsevišķs virtuālais vide. Pēdējais punkts nav tikai kosmētika: MCP pakotnes attīstās strauji, un atsevišķa virtuālā vide katram projektam novērš situāciju, kurā, instalējot atkarību citam projektam, tu sabojā jau strādājošu serveri.

# Izveido virtuālo vidi
python -m venv mcp-env
source mcp-env/bin/activate  # Linux/Mac
# mcp-env\Scripts\activate   # Windows

# Oficiālais MCP SDK (v2) un Mistral SDK ar tā aģentu papildinājumu
pip install "mcp[cli]>=2.2,<3" "mistralai[agents]"

Servera rakstīšana

Izmantojot MCPServer — augsta līmeņa klasi oficiālajā SDK (agrāk FastMCP) — lokāla servera izveidei pietiek ar dažām rindiņām. Tu inicializē lietojumprogrammu, piešķirot tai aprakstošu nosaukumu, un pēc tam dekorē savas Python funkcijas ar @app.tool(), lai tās eksponētu.

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

# Inicializē serveri ar aprakstošu nosaukumu
app = MCPServer("Local Demo Server")

@app.tool()
def greet(name: str) -> str:
    """Sveic personu pēc vārda.

    Args:
        name: Personas, ko sveikt, vārds

    Returns:
        Personalizēts sveiciena ziņojums
    """
    return f"Hello {name}! Welcome to the world of MCP."

@app.tool()
def calculate(operation: str, a: float, b: float) -> str:
    """Veic vienkāršu matemātisku aprēķinu.

    Args:
        operation: Veicamā darbība (add, sub, mul, div)
        a: Pirmais skaitlis
        b: Otrais skaitlis

    Returns:
        Aprēķina rezultāts
    """
    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}"

Šis fails eksponē divus rīkus. Pievērs uzmanību docstringu lomai: tie ne tikai dokumentē tavu kodu kolēģim, bet burtiski kļūst par aprakstu, ko modelis lasa, lai izlemtu, vai izsaukt calculate vai greet. Neprecīzs docstring šeit novedīs pie haotiskiem izsaukumiem vēlāk.

STDIO klienta konfigurēšana

Klienta pusē tu nepieslēdzies adresei; tu paskaidro, kā palaist serveri. Tieši šo lomu pilda StdioServerParameters.

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

# Ceļš uz tavu serveri
path_to_server = Path("serveur_local.py")

# STDIO servera konfigurācija
server_params = StdioServerParameters(
    command="python",           # Komanda servera palaišanai
    args=[str(path_to_server)], # Argumenti (Python fails)
    env=None,                   # Vides mainīgie (neobligāti)
)

# Izveido MCP klientu
mcp_client = MCPClientSTDIO(stdio_params=server_params)

Trīs parametri ir pelnījuši detalizētāku apskatu.

command

Šī ir sistēmas komanda, kas palaiž servera procesu: "python" Python serverim, "node" JavaScript serverim vai tiešs ceļš uz bināro failu, ja tavs serveris ir kompilēts.

# Python
command="python"

# Node.js
command="node"

# Kompilēts izpildāmais fails
command="./mon_serveur_mcp"

args

Šis ir argumentu saraksts, kas tiek nodots šai komandai. Python skriptam tas minimāli ir faila ceļš, taču nekas neliedz šeit nodot arī servera opcijas.

# Vienkāršs skripts
args=["serveur_local.py"]

# Ar papildu argumentiem
args=["serveur_local.py", "--port", "8080", "--verbose"]

env

Šī ir vides mainīgo vārdnīca, kas tiek nodota servera procesam: kanāls, caur kuru tu tam nodod API atslēgu, datubāzes URL vai atkļūdošanas karogu.

import os

server_params = StdioServerParameters(
    command="python",
    args=["serveur_local.py"],
    env={
        **os.environ,  # Manto no pašreizējās vides
        "API_KEY": "your_api_key",
        "DATABASE_URL": "postgresql://...",
        "DEBUG": "true",
    },
)

Šī parametra uzvedība bieži pārsteidz lietotājus. Ar env=None serveris manto visu vecākprocesa vidi; ar vārdnīcu tas redz tikai uzskaitītos mainīgos. Ja tu norādi vārdnīcu, neiekļaujot tajā os.environ, nebrīnies, ja tavs serveris vairs neatrod savu PATH vai tavu API atslēgu: uzvedība ir pilnīgi loģiska, vienkārši radikāla.

Testē pirms integrācijas

Pirms servera pieslēgšanas aģentam, testē to izolēti, izmantojot MCP Inspector. Loģika ir vienkārša: ja izsaukums neizdodas, kad serveris ir savienots ar modeli, tu nezini, vai problēma slēpjas tavā kodā vai modeļa lēmumā. Inspector šo neskaidrību novērš.

npx @modelcontextprotocol/inspector python serveur_local.py

Komanda atver lokālu tīmekļa saskarni, kurā vari uzskaitīt eksponētos rīkus, pārbaudīt aprakstu un parametrus, ko saņems modelis, manuāli izsaukt tos ar pašizvēlētiem argumentiem un pārbaudīt atgrieztās vērtības precīzo formātu. Pieradini sevi to izmantot sistemātiski: tās ir piecas minūtes, kas ietaupa stundu.

Visbeidzot, lūk failu organizācija, kas kalpo ilgtermiņā, ar serveri, klientu, atkarībām, noslēpumiem, kas glabāti ārpus repozitorija, un vienību testiem taviem rīkiem:

mon-projet-mcp/
├── serveur_local.py     # MCP serveris
├── client_stdio.py      # Klienta skripts
├── requirements.txt     # Atkarības
├── .env                 # Vides mainīgie (nekad neiekļauj repozitorijā)
└── tests/
    └── test_tools.py    # Rīku vienību testi

Galvenās atziņas

  • STDIO serveris tiek palaists kā lokāls process
  • StdioServerParameters konfigurē komandu, argumentus un vides mainīgos
  • Tavu rīku docstringi kalpo kā apraksts modelim
  • MCP Inspector (npx @modelcontextprotocol/inspector) ir būtisks testēšanai
  • env=None manto visu vidi; eksplicīta vārdnīca ierobežo mainīgos