Uirlisí, Acmhainní, agus Leideanna i MCP
Ar an leathanach seo
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éannMCPServerin ionadFastMCP, bogann socruithe iompair gorun()nóstreamable_http_app(), agus caolfaidh feidhmchlár nochta faoi óstainm fíor an t-óstainm sin a dhearbhú (transport_security). Is é seo an leagan a éilíonn an Mistral SDK freisin: éilíonn an breiseánmistralai[agents]go mbeadhmcp>=2.2.0,<3.0ann. Foinse: Cad atá nua i v2 · Treoir Imirce · Deighilt & Scálú.
Trí chumas, trí rún
Is féidir le freastalaí MCP trí chineál cumais a nochtadh dá chliaint. Níl siad inmhalartaithe: freagraíonn gach ceann do riachtanas ar leith, agus má mheascann tú an triúr, cruthaíonn tú freastalaithe atá deacair don mhúnla a úsáid. Scrúdaímid iad ceann ar cheann sa cheacht seo, sula ndéanaimid dul i ngleic leis an gceist a shocraíonn cáilíocht an fhreastalaí: cé mhéad uirlis, agus cén ghránúlacht.
Uirlisí: feidhmeanna inrite
Is iad na huirlisí an cumas is forleithne den phrótacal. Is feidhm í uirlis ar féidir leis an mhúnla cinneadh a dhéanamh í a ghlaow chun gníomh a dhéanamh nó faisnéis a fháil. Braitheann a sainmhíniú ar cheithre eilimint: ainm uathúil, cur síosach (create_issue, get_weather), cur síos téacs a insíonn don mhúnla cathain é a ghlaow, scéama JSON do pharaiméadair ionchuir lena gcineálacha agus a srianta, agus formáid fillte—go minic téacs nó JSON.
from mcp.server.mcpserver import MCPServer
app = MCPServer("My Server")
@app.tool()
def get_weather(latitude: float, longitude: float) -> str:
"""Retrieves current weather for the given coordinates.
Args:
latitude: Latitude in decimal degrees (-90 to 90)
longitude: Longitude in decimal degrees (-180 to 180)
Returns:
Text description of current weather
"""
# Weather API call logic
return f"Sunny, 22°C at ({latitude}, {longitude})"
Ná déan neamhaird ar an gcur síos agus ar an gclóscríobh: ní fheiceann an mhúnla aon rud eile. Níl rochtain aici ar do chód, ní féidir léi do rúin a thuar, agus ní féidir léi glao a thástáil chun a fheiceáil cad a tharlóidh. Cruthaíonn cur síosanna doiléire nó paraiméadair atá clóscríofa go mícheart glaonna míchearta go meicniúil.
Déanann roinnt nósanna do chuid uirlisí i bhfad níos iontaofa. Ainmnigh iad de réir an rud a dhéanann siad—insíonn book_restaurant gach rud, ní insíonn process_request aon rud—agus déan cur síos ar an ngníomh agus ar an ábhar fillte araon, ós rud é go gcaithfidh an mhúnla réamh-mheastachán a dhéanamh ar an rud a gheobhaidh sí. Déan anótáil i gcónaí ar pharaiméadair i bPython agus scríobh docstrings struchtúrtha le Args agus Returns: cothaíonn siad seo an scéama a fheiceann an mhúnla. Ar deireadh, fill luachanna inléite seachas aitheantóirí doiléire; ligeann uirlis a fhillteann "John Smith" don mhúnla abairt a chumadh, ach cuireann uirlis a fhillteann UUID iallach uirthi buille faoi thuairim a dhéanamh.
Acmhainní: sonraí inléite
Nochtann acmhainní sonraí is féidir leis an gcliant a léamh gan fo-iarsmaí. Braitheann an difríocht le huirlisí ar bhriathar amháin: déanann uirlis rud éigin, chuimsíonn acmhainn rud éigin. Is acmhainní nádúrtha iad inneachar comhaid cumraíochta, bonn eolais, doiciméadú API, nó stádas reatha córais.
@app.resource("config://database")
def get_db_config() -> str:
"""Current database configuration."""
return json.dumps({
"host": "localhost",
"port": 5432,
"database": "production"
})
Sainaithnítear gach acmhainn le URI—config://database, file:///path/to/doc—is féidir leis an gcliant a liostú agus ansin a léamh ar éileamh. Go praiticiúil, úsáidtear iad níos lú ná uirlisí, ós rud é go gcumhdaíonn uirlis shimplí a fhillteann sonraí an chuid is mó de na riachtanais. Fanann siad úsáideach nuair is mian leat sonraí statacha nó leath-statacha a fhoilsiú gan aon loighic feidhmiúcháin taobh thiar díobh.
Leideanna: teimpléid in-athúsáidte
Is teimpléid inpharaiméadrúcháin iad Leideanna MCP a chuireann an freastalaí ar fáil. Freastalaíonn siad chun treoracha cruthaithe a roinnt do thasc ar leith, in ionad ligean do gach duine a gcur chuige féin a athchruthú.
@app.prompt()
def code_review(language: str, code: str) -> str:
"""Generates a code review prompt for the given language."""
return f"""You are an expert in {language}.
Analyze the following code and identify:
1. Potential bugs
2. Performance issues
3. Readability improvements
Code to analyze:
```{language}
{code}
```"""
Is sa timpeallacht foirne a dhéanann an úsáid seo an chiall is mó. Códálann forbróir sinsearach a chuid leideanna athbhreithnithe cóid, dífhabhtaithe, nó anailíse ailtireachta isteach i bhfreastalaí MCP, agus bíonn rochtain ag an bhfoireann iomlán orthu óna gcliant féin leis an gcáilíocht treorach céanna.
Comhchaibidlíocht cumais
Nuair a nascann cliant le freastalaí, téann céim chomhchaibidlíochta i bhfeidhm roimh aon úsáid:
- Iarrann an cliant cumais an fhreastalaí
- Freagraíonn an freastalaí lena liosta uirlisí, acmhainní, agus leideanna
- Cuireann an cliant na cumais seo i láthair don mhúnla teanga
- Úsáideann an mhúnla na cur síosanna chun cinneadh a dhéanamh cad le glaow
Tá an chomhchaibidlíocht seo dinimiciúil, agus is airí inúsáidte é sin: is féidir leis an bhfreastalaí céanna cumais éagsúla a fhógairt ag brath ar an úsáideoir nasctha nó ar chomhthéacs an ghlao—feicfidh cuntas riarthóra uirlisí nach bhfeicfidh cuntas inléite amháin riamh.
Cé mhéad uirlis in aghaidh an fhreastalaí?
Dealraíonn sé go bhfuil an cheist suarach, ach coinníonn sí ráta earráide do ghníomhaire faoi smacht. Coinnigh do chuid freastalaithe dírithe: oibríonn trí go deich n-uirlis atá sainmhínithe go maith níos fearr ná caoga cinn ghinearálta. Thar toirt áirithe, scaipeann an mhúnla a roghanna agus críochnaíonn sí ag glaow ar an uirlis mhícheart, nó ag carnadh glaonna nach bhfuil gá leo.
Má tá do raon feidhme feidhmiúil leathan, roinn ina roinnt freastalaithe speisialaithe é—ceann amháin d’oibríochtaí Git, ceann amháin do bhainistíocht tionscadail, ceann amháin do mhonatóireacht. Tá a fhios ag an gcliant conas nascadh le roinnt freastalaithe ag an am céanna agus na cinn sin amháin a ghníomhachtú a theastaíonn don tasc reatha, rud a ionann agus an comhthéacs úsáideach a lódáil seachas an catalóg iomlán.
Is fiú d’aird a thabhairt ar thrádáil dheireanach amháin: gránúlacht. Má nochtann tú trí uirlis chun bialanna a liostú, infhaighteacht a sheiceáil, agus ansin áirithint a dhéanamh, cuireann tú iallach ar an mhúnla seicheamh a chomhordú, le riosca earráide ag gach céim. Cuimsíonn uirlis sreabha oibre amháin—book_restaurant—an seicheamh iomlán, laghdaíonn sí líon na dturais fillte, agus bogann sí loighic ghnó go dtí an áit atá in-tástáilte: i do chód.
Príomhphointí
- Uirlisí = gníomhartha inrite (90% de chásanna úsáide), éilíonn cur síos agus clóscríobh cruinn
- Acmhainní = sonraí inléite trí URI, gan fo-iarsmaí
- Leideanna = teimpléid in-athúsáidte, úsáideach d’fhoirne
- Coinnigh do chuid freastalaithe dírithe (3–10 n-uirlis ar a mhéad)
- Tosaigh uirlisí sreabha oibre thar uirlisí atá róghránúil
- Cinneann cáilíocht an chur síos éifeachtúlacht na samhla