Léim go dtí an príomhábhar
Gaeilge— Roghnaigh teanga
Roghchlár

Cumraigh Freastalaí MCP Logánta (STDIO)

Ceacht 4 as 14 Nuashonraithe 2 Samhain 2026 Forbróir
Ar an leathanach seo
  1. Do chéad fhreastalaí MCP logánta
  2. An freastalaí a scríobh
  3. An cliant STDIO a chumrú
  4. Tástáil sula ndéanann tú comhtháthú
  5. Príomhphointí

Nuashonraithe an 2 Samhain, 2026 — MCP Python SDK v2. Leanann an cúrsa seo anois leagan 2 den SDK mcp (2.3.0 ón 2 Deireadh Fómhair, 2026): téann MCPServer in ionad FastMCP, bogann socruithe iompair go run() nó streamable_http_app(), agus caolfaidh feidhmchlár nochta faoi óstainn realta an t-óstainn sin a dhearbhú (transport_security). Is é seo an leagan a éilíonn an Mistral SDK freisin: éilíonn an breiseán mistralai[agents] go mbeadh mcp>=2.2.0,<3.0 ann. Foinse: Cad atá nua i v2 · Treoir Imirce · Deighil & scála.

Do chéad fhreastalaí MCP logánta

Is é an mód STDIO an pointe tosaigh nádúrtha chun freastalaí MCP a fhorbairt agus a thástáil: ritear gach rud ar do mheaisín féin, gan aon deighilt, gan URL poiblí, agus gan teastais le bainistiú. Cuirtear comhad in eagar, atosnaítear é, agus déantar breathnú air. Sa cheacht seo, scríobhfaidh tú freastalaí MCP logánta i Python agus nascfaidh tú le cliant é ina dhiaidh sin.

Maidir leis na réamhriachtanais, teastaíonn Python 3.10 nó níos airde, pip cothrom le dáta, agus timpeallacht fhíorúil tiomnaithe de rogha ort. Ní gné chosmaideach é an pointe deireanach sin: athraíonn pacáistí MCP go tapa, agus coscann venv ar leithle do gach tionscadal ort freastalaí atá ag obair a bhriseadh nuair a shuiteálann tú spleáchas do thionscadal eile.

# Cruthaigh timpeallacht fhíorúil
python -m venv mcp-env
source mcp-env/bin/activate  # Linux/Mac
# mcp-env\Scripts\activate   # Windows

# SDK MCP oifigiúil (v2) agus Mistral SDK lena bhreiseán agents
pip install "mcp[cli]>=2.2,<3" "mistralai[agents]"

An freastalaí a scríobh

Le MCPServer, an rang ardleibhéil sa SDK oifigiúil (a bhíodh ina FastMCP), ní ghlacann freastalaí logánta ach cúpla líne. Déanann tú samplú ar fheidhmchlár trí ainm cur síosach a thabhairt dó, agus ansin cuirimid do fheidhmeanna Python le @app.tool() chun iad a nochtadh.

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

# Tosaigh an freastalaí le hainm cur síosach
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}"

Nochtann an comhad seo dhá uirlis. Tabhair faoi deara ról na ndoiciméad strings: ní hamháin go ndéanann siad do chód a dhoiciméadú do chomhghleacaí; is iad go díreach an cur síos a léann an tsamhail chun cinneadh a dhéanamh an calculate a ghlaowh in ionad greet. Má bhíonn docstring míchúramach anseo, beidh glaonna neamhrialta ann ina dhiaidh sin.

An cliant STDIO a chumrú

Ar thaobh an chliaint, ní bhfuil tú ag nascadh le seoladh; tá tú ag míniú conas an freastalaí a thosú. Sin ról StdioServerParameters.

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

# Conair go dtí do fhreastalaí
path_to_server = Path("serveur_local.py")

# Cumraíocht freastalaí STDIO
server_params = StdioServerParameters(
    command="python",           # An t-ordú chun an freastalaí a sheoladh
    args=[str(path_to_server)], # Na hargóintí (an comhad Python)
    env=None,                   # Athróga timpeallachta (roghnach)
)

# Cruthaigh an cliant MCP
mcp_client = MCPClientSTDIO(stdio_params=server_params)

Tá trí pharaiméadar a thuilleann mionsonraí.

command

Is é seo an t-ordú córais a sheolann próiseas an fhreastalaí: "python" do fhreastalaí Python, "node" do fhreastalaí JavaScript, nó an conair dhíreach go dtí dénártha má tá do fhreastalaí tiomsaithe.

# Python
command="python"

# Node.js
command="node"

# Feidhmchlár tiomsaithe
command="./mon_serveur_mcp"

args

Is é seo an liosta argóintí a chuirtear chuig an ordú sin. I gcás scripte Python, is é conair an chomhaid an t-íosmhéid, ach ní chuireann sé bac ort roghanna do fhreastalaí a chur ann.

# Script shimplí
args=["serveur_local.py"]

# Le hargóintí breise
args=["serveur_local.py", "--port", "8080", "--verbose"]

env

Is é seo an foclóir d’athróga timpeallachta a chuirtear chuig próiseas an fhreastalaí: an bealach trína gcuireann tú eochair API, URL bunachair sonraí, nó bratach dífhabhtaithe ar fáil dó.

import os

server_params = StdioServerParameters(
    command="python",
    args=["serveur_local.py"],
    env={
        **os.environ,  # Oidhreacht ón timpeallacht reatha
        "API_KEY": "your_api_key",
        "DATABASE_URL": "postgresql://...",
        "DEBUG": "true",
    },
)

Go minic, cuireann iompar an pharaiméadair seo iontas ar dhaoine. Le env=None, faigheann an freastalaí an timpeallacht iomlán ón bpróiseas tuismitheora; le foclóir, ní fheiceann sé ach na hathróga atá liostaithe go docht. Má sholáthraíonn tú foclóir gan os.environ a chaitheamh isteach ann, ná bíodh iontas ort mura féidir le do fhreastalaí do PATH nó d’eochair API a aimsiú a thuilleadh: tá an t-iompar loighciúil go hiomlán, ach radacach freisin.

Tástáil sula ndéanann tú comhtháthú

Sula gcuireann tú do fhreastalaí isteach i ngníomhaire, déan é a thástáil ina aonar leis an MCP Inspector. Is simplí an réasúnaíocht: má theipeann ar ghlaoidh nuair a bhíonn an freastalaí nasctha le samhail, ní bheidh a fhios agat an bhfuil an fhadhb i do chód nó i gcinneadh na samhla. Baineann an tInspector an débhríocht seo.

npx @modelcontextprotocol/inspector python serveur_local.py

Osclaíonn an t-ordú comhéadan gréasáin logánta inar féidir leat na huirlisí nochttha a liostú, iniúchadh a dhéanamh ar an gcur síos agus na paraiméadair a gheobhaidh an tsamhail, glaoidh láimhe a spreagadh le hargóintí de do rogha féin, agus fíorú a dhéanamh ar fhormáid cruinn an luacha fillte. Déan cleachtas de bheith á úsáid go córasach: cúig nóiméad a shábhálann uair an chloig.

Ar deireadh, seo eagrú comhaid a mhaireann go maith, leis an bhfreastalaí, an cliant, na spleáchais, na rúin ar coimeád amach as an stór, agus tástálacha aonaid do d’uirlisí:

mon-projet-mcp/
├── serveur_local.py     # An freastalaí MCP
├── client_stdio.py      # An script cliant
├── requirements.txt     # Spleáchais
├── .env                 # Athróga timpeallachta (ná cuir i gcomóid riamh iad)
└── tests/
    └── test_tools.py    # Tástálacha aonaid d'uirlisí

Príomhphointí

  • Seolann freastalaí STDIO mar phróiseas logánta
  • Cumraíonn StdioServerParameters an t-ordú, na hargóintí, agus na hathróga timpeallachta
  • Feidhmíonn docstrings do chuid uirlisí mar an cur síos don tsamhail
  • Tá an MCP Inspector (npx @modelcontextprotocol/inspector) riachtanach le haghaidh tástála
  • Oidhreachtaí env=None an timpeallacht iomlán; teorannaíonn foclóir sainráite na hathróga