Sampla Iomlán: Freastalaí Cianda le Fíordheimhniú
Ar an leathanach seo
Nuashonrú 2 Samhain, 2026 — Is é Vibe anois é Le Chat. Ón 28 Bealtaine, 2026, athbhrandáladh Le Chat mar Vibe (fós ag chat.mistral.ai): gníomhaire amháin don obair agus don chód, ag coimeád do chomhráite, do shocruithe, agus do shíntiúis. Tá an t-eispéireas Le Chat traidisiúnta fós inrochtana sa mhód Chat; sa mhód Oibre, is scileanna iad na gníomhairí anois (glaofar orthu le
@), feidhmíonn cuimhní mar bhunachar eolais, agus is é an scil Taighde Doimhin é an cuardach doimhin. Tugtar Mistral Free, Pro, Team, agus Enterprise ar na pleananna anois. Úsáideann an ceacht seo an t-ainm Vibe; d’fhéadfadh roinnt rochláir a thuairiscítear anseo a n-ainmneacha nó a suíomhanna a bheith athraithe. Forlíonadh 3 Samhain: léitear torthaírun_asyncóresult.output_as_text; níl aon tréithoutputag SDKmistralai3.7.0.
Nuashonrú 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 aip a nochtar 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ú.
Cás: Freastalaí MCP Bainistithe Tascanna
Chumhdaigh ceachtaí roimhe seo na píosaí aonair: iompar HTTP, meánbhogearraí, agus fíordheimhniú chomhartha. Anois, cuirfidh tú le chéile iad chun tionscadal atá feidhmiúil go hiomlán a chruthú. Nochtann an freastalaí ceithre uirlis bainistithe tascanna—cruthaigh, liostaigh, críochnaigh, scrios—agus déanann an cliant nascadh go cianda, ag cur comhartha iompróra i láthair le gach iarratas. Rithfidh an freastalaí céanna seo ó Vibe gan aon líne bhreise cóid: sin an buntáiste iomlán a bhaineann le freastalaí cianda thar freastalaí STDIO.
An Freastalaí: task_server.py
Tá trí eilimint i gcomhfhogas sa chomhad aonair seo. Déileálann FastAPI le hiompar HTTP agus meánbhogearraí fíordheimhnithe, déileálann MCPServer leis an bprótacal MCP agus na huirlisí, agus feidhmíonn foclóir Python mar bhunachar sonraí. Tá tábhacht le hord na gcomhad: dearbhaigh an freastalaí MCP agus a chuid uirlisí ar dtús, ansin cruthaigh an aip FastAPI leis an lifespan a thosaíonn an bainisteoir seisiúin, agus suiteáil an freastalaí ar deireadh. Tabhair faoi deara go gcosnaíonn na meánbhogearraí an conair /tasks, áit a bhfuil an freastalaí MCP suiteáilte go díreach: caithfidh an dá luach seo teacht le chéile, nó beidh doras oscailte nó conair bhallaí timpeall air agat.
# task_server.py
"""Freastalaí MCP cianda le fíordheimhniú comhartha."""
import json
import os
import uuid
from contextlib import asynccontextmanager
from datetime import datetime
from fastapi import FastAPI, Request, HTTPException
from mcp.server.mcpserver import MCPServer
from mcp.server.transport_security import TransportSecuritySettings
# --- Cumraíocht ---
API_TOKEN = "mcp-secret-token-2026"
# --- Bunachar sonraí sa chuimhne ---
tasks_db: dict[str, dict] = {}
# --- Freastalaí MCP ---
mcp = MCPServer("Task Manager")
@mcp.tool()
def create_task(title: str, description: str = "", priority: str = "medium") -> str:
"""Cruthaíonn sé tasc nua sa bhainisteoir.
Args:
title: Teideal an tasc (riachtanach, uasmhéid 200 carachtar)
description: Cur síos mionsonraithe (roghnach)
priority: Leibhéal tosaíochta: low, medium, high (réamhshocrú: medium)
Returns:
JSON leis an ID agus mionsonraí an tasc a cruthaíodh
"""
task_id = str(uuid.uuid4())[:8]
task = {
"id": task_id,
"title": title[:200],
"description": description,
"priority": priority if priority in ("low", "medium", "high") else "medium",
"status": "open",
"created_at": datetime.now().isoformat(),
}
tasks_db[task_id] = task
return json.dumps({"success": True, "task": task}, ensure_ascii=False)
@mcp.tool()
def list_tasks(status: str = "all", priority: str = "all") -> str:
"""Liostaíonn sé tascanna le scagairí roghnacha.
Args:
status: Scag de réir stádais: all, open, completed (réamhshocrú: all)
priority: Scag de réir tosaíochta: all, low, medium, high (réamhshocrú: all)
Returns:
JSON leis an liosta tascanna agus an comhaireamh iomlán
"""
filtered = list(tasks_db.values())
if status != "all":
filtered = [t for t in filtered if t["status"] == status]
if priority != "all":
filtered = [t for t in filtered if t["priority"] == priority]
return json.dumps({
"total": len(filtered),
"tasks": filtered,
}, ensure_ascii=False)
@mcp.tool()
def complete_task(task_id: str) -> str:
"""Marcálann sé tasc mar chríochnaithe.
Args:
task_id: An t-aithneoir uathúil don tasc
Returns:
Deimhniú ar an nuashonrú nó teachtaireacht earráide
"""
if task_id not in tasks_db:
return json.dumps({"error": f"Task {task_id} not found"})
tasks_db[task_id]["status"] = "completed"
tasks_db[task_id]["completed_at"] = datetime.now().isoformat()
return json.dumps({"success": True, "task": tasks_db[task_id]}, ensure_ascii=False)
@mcp.tool()
def delete_task(task_id: str) -> str:
"""Scriosann sé tasc ón mbainisteoir.
Args:
task_id: An t-aithneoir uathúil don tasc le scriosadh
Returns:
Deimhniú ar an scriosadh nó teachtaireacht earráide
"""
if task_id not in tasks_db:
return json.dumps({"error": f"Task {task_id} not found"})
deleted = tasks_db.pop(task_id)
return json.dumps({"success": True, "deleted_task": deleted["title"]}, ensure_ascii=False)
# --- Suiteáil an fhreastalaí MCP i FastAPI ---
# Cruthaíonn streamable_http_app() an aip ASGI don fhreastalaí MCP.
# Caithfear a bhainisteoir seisiúin a thosú ag lifespan FastAPI,
# murach sin freagraíonn an freastalaí ach teipeann ar gach glaoh uirlise.
@asynccontextmanager
async def lifespan(app: FastAPI):
async with mcp.session_manager.run():
yield
api = FastAPI(title="Task Manager MCP", lifespan=lifespan)
# --- Meánbhogearraí Fíordheimhnithe ---
@api.middleware("http")
async def auth_middleware(request: Request, call_next):
"""Fíoraíonn sé an comhartha do gach conair /tasks."""
if request.url.path.startswith("/tasks"):
auth = request.headers.get("Authorization", "")
if auth != f"Bearer {API_TOKEN}":
raise HTTPException(status_code=401, detail="Invalid token")
return await call_next(request)
# Óstainm poiblí (ngrok, fearann táirgeachta) dearbhaithe don fhreastalaí MCP
PUBLIC_HOST = os.environ.get("MCP_PUBLIC_HOST", "localhost")
securite = TransportSecuritySettings(
allowed_hosts=[PUBLIC_HOST, f"{PUBLIC_HOST}:*", "localhost:*", "127.0.0.1:*"]
)
api.mount("/tasks", mcp.streamable_http_app(transport_security=securite))
if __name__ == "__main__":
import uvicorn
uvicorn.run(api, host="0.0.0.0", port=8000)
Tá dhá shonra cur chun feidhme a thuilleann do aire. I create_task, gearrtar an teideal go 200 carachtar agus téann an tosaíocht go medium mura bhfuil an luach a fuarthas sa liosta ceadaithe: uaireanta molann an tsamhail luachanna atá inchreidte ach lasmuigh den chonradh, agus caithfidh an uirlis fanacht láidir gan teip. I complete_task agus delete_task, ní chruthaíonn ID anaithnid eisceacht ach filleann sé teachtaireacht earráide JSON—is féidir leis an tsamhail é seo a léamh, a botún a thuiscint, agus athfhráisiú a dhéanamh, rud a chuirfeadh tuairteáil cosc air.
Seoladh agus Nochtadh an Fhreastalaí
# Sa chéad teirminéal, oscail an tollán ngrok
ngrok http 8000
# URL Poiblí: https://xyz789.ngrok-free.app
# Sa dara teirminéal, seol an freastalaí ag dearbhú an óstainm seo
MCP_PUBLIC_HOST=xyz789.ngrok-free.app python task_server.py
Tá an críochphointe MCP suite ansin ag https://xyz789.ngrok-free.app/tasks/mcp. Tabhair faoi deara comhdhéanamh an seolta seo: an URL poiblí a sholáthraíonn ngrok, ar a leanann an conair shuiteála /tasks, agus ansin an iarmhír /mcp a chuireann an SDK leis. Is é míthuiscint faoin gcomhcheangal seo an phríomhchúis le teipeanna nasctha.
An Cliant: client_tasks.py
Ar thaobh an chliaint, ní athraíonn aon rud i gcomparáid le freastalaí áitiúil seachas cineál an chliaint MCP agus cur leis an gceanntásc fíordheimhnithe. Faigheann an gníomhaire treoracha áfach a dhéanann cur síos ar a ról i ngnáththeanga—spreagann sé seo é gach gníomh a dheimhniú seachas glaonna a shlabhrú go ciúin.
# client_tasks.py
"""Cliant MCP don fhreastalaí tascanna cianda le fíordheimhniú."""
import asyncio
import os
from mistralai.client import Mistral
from mistralai.extra.run.context import RunContext
from mistralai.extra.mcp.streamable_http import (
MCPClientStreamableHTTP,
StreamableHTTPServerParams,
)
API_TOKEN = "mcp-secret-token-2026"
SERVER_URL = "https://xyz789.ngrok-free.app/tasks/mcp"
async def main():
client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])
# Cruthaigh an gníomhaire le treoracha oiriúnaithe
agent = client.beta.agents.create(
model="mistral-medium-latest",
name="task-manager",
instructions=(
"You are an intelligent task manager. "
"Use the available tools to create, list, and manage "
"the user's tasks. Respond in English. "
"Confirm every action performed."
),
)
# Cumraigh an cliant MCP cianda le fíordheimhniú
mcp_client = MCPClientStreamableHTTP(
params=StreamableHTTPServerParams(
url=SERVER_URL,
headers={"Authorization": f"Bearer {API_TOKEN}"},
timeout=30,
)
)
async with RunContext(
agent_id=agent.id,
continue_on_fn_error=True,
) as run_ctx:
await run_ctx.register_mcp_client(mcp_client=mcp_client)
# Comhrá leis an mbainisteoir
conversations = [
"Create a high priority task: Prepare the MCP presentation",
"Create a medium priority task: Review the documentation",
"List all ongoing tasks",
"Mark the first task as completed",
"Show me the remaining tasks",
]
for msg in conversations:
print(f"\n> {msg}")
result = await client.beta.conversations.run_async(
run_ctx=run_ctx,
inputs=msg,
)
print(f"Agent: {result.output_as_text}")
asyncio.run(main())
Tá an seicheamh teachtaireachtaí d’aon turas: slabhraíonn sé dhá chruthú, léamh, nuashonrú, agus athléamh. Is é seo an cás íosta chun a fhíorú go maireann an stát ó ghlao go glao agus go bhfuil an tsamhail in ann ID tasc a cruthaíodh níos luaithe sa chomhrá a aisghabháil. Má theipeann ar an gceathrú treoir, is annamh a bhíonn an fhadhb leis an bhfreastalaí: de ghnáth eascraíonn sé as nach bhfuil na hIDanna le feiceáil go leor i bhfreagra list_tasks.
Tástáil i Mistral Vibe
Is féidir an críochphointe céanna a chur leis go díreach mar nascóir saincheaptha, rud a thugann comhéadan tástála duit gan cliant a scríobh. Is é seo an bealach is fearr freisin chun do dhoicstringí a bhailíochtú: taispeánann Vibe iad mar atá siad le linn aimsithe, mar sin feiceann tú láithreach cad a bheidh os comhair na samhla chun cinneadh a dhéanamh cé acu uirlis a ghlaofar.
- Téigh go dtí an cluaisín Connectors i Vibe
- Cliceáil Add Custom Connector
- Cuir isteach Name mar
Task Manager, URL marhttps://xyz789.ngrok-free.app/tasks/mcp, ansin roghnaigh Auth: Token agus greamaighmcp-secret-token-2026 - Cliceáil Connect
Aimsíonn Vibe na ceithre uirlis go huathoibríoch ansin, agus is féidir leat comhrá a dhéanamh i ngnáththeanga le do fhreastalaí féin.
Eagrú an Tionscadail agus na Chéad Chéimeanna Eile
task-mcp-project/
├── task_server.py # Freastalaí MCP + FastAPI + auth
├── client_tasks.py # Cliant Python le gníomhaire
├── requirements.txt # fastapi, uvicorn, mcp>=2.2,<3, mistralai[agents]
└── .env # MISTRAL_API_KEY, API_TOKEN
Oibríonn an creatlach seo le haghaidh prótatípú, ach tá dhá rud a dhícháilíonn é don táirgeadh. Caithfidh an comhartha téacs simplí sa chód foinseach bogadh go .env, agus athraíonn an URL ngrok ag gach atosú, rud a bhriseann gach nascóir cumraithe. Is é ngrok fós an uirlis idéalach chun smaoineamh a bhailíochtú i gceann cúpla nóiméad; is é óstáil bhuan, lena roghanna Docker, scamall, agus Hugging Face Spaces, ábhar cheacht 12.
Príomhphointí
- Comhcheanglaíonn freastalaí cianda FastAPI (HTTP) +
MCPServer(MCP) + meánbhogearraí (auth), leis an óstainm poiblí dearbhaithe itransport_security - Déileáiltear le fíordheimhniú comhartha tríd an gceanntásc
Authorization: Bearer ... - Glacann an cliant
MCPClientStreamableHTTPle ceanntáisc shaincheaptha le haghaidh fíordheimhnithe - Is féidir an freastalaí céanna a úsáid ón Python SDK agus ó Mistral Vibe
- Cuireann ngrok prótatípú tapa ar chumas sula ndéantar deighilt táirgeachta