Versionshantera verktyg och scheman
Vidareutveckla servern utan att bryta klienterna.
Versionshantera verktyg och scheman är en gratis lektion i MCP Academy på CoddyKit. Detta är lektion 4 av 4. Du kan läsa vilka 3 lektioner som helst i den här lärvägen kostnadsfritt i sin helhet – därefter låser CoddyKit PRO upp alla lektioner, plus praktisk övning med en inbyggd kodredigerare och en AI-lärare dygnet runt. Den ingår i lärvägen för MCP Academy, och Era framsteg synkroniseras mellan webben och CoddyKit-appen. Kursen i MCP Academy innehåller totalt 4 lektioner.
Klienter är beroende av dina strukturer
När andra väl har anslutit sig förlitar de sig på dina verktygsnamn och argumentens strukturer. Om du ändrar dem vårdslöst slutar alla klienter att fungera samtidigt.
Tilläggsändringar är säkra
Om du lägger till en valfri parameter med ett standardvärde fortsätter gamla anropare att fungera. De ignorerar helt enkelt det nya fältet som de inte skickar.
def search(q: str, limit: int = 10) -> list:
...Brytande ändringar gör ont
Att byta namn på ett verktyg, ta bort ett argument eller göra ett argument obligatoriskt är brytande ändringar. Befintliga klienter skickar plötsligt anrop som inte längre passar.
Lägg till och markera sedan som föråldrat
Om ett fält ska utvecklas lägger du till det nya och behåller det gamla. Markera det gamla som föråldrat i beskrivningen så att anroparna vet att de ska migrera.
Version i verktygsnamnet
Vid en verklig brytande ändring levererar du ett v2-verktyg bredvid v1. Båda körs under en tid, så att klienterna kan byta i sin egen takt.
@mcp.tool(name="search_v2")
def search_v2(query: str) -> list:
...Servern rapporterar sin version
Din server meddelar ett namn och en version under handskakningen. Uppdatera den så att klienterna kan se vilken utgåva de anslöt till.
mcp = FastMCP("my-server")
# version surfaces in server infoFölj semantisk versionshantering
Använd semver: öka patchversionen för korrigeringar, minorversionen för tilläggsfunktioner och majorversionen när du gör en brytande ändring. Siffran berättar en historia.
Bredda utdata, begränsa dem inte
Att lägga till ett fält i ett resultat är vanligtvis säkert, medan det är brytande att ta bort ett. Betrakta ditt utdataschema som ett löfte som klienterna tolkar.
För en ändringslogg
Dokumentera alla ändringar i verktyg och scheman i en ändringslogg. Användare som uppgraderar behöver se vad som har ändrats, vad som är nytt och vad som har tagits bort.
Ange ett slutdatum för föråldrade funktioner
Meddela när ett gammalt verktyg kommer att tas bort. Ett tydligt slutdatum driver på migreringen utan att plötsligt rycka undan mattan för någon.
Testa mot gamla klienter
Innan lanseringen kör du dina tester så som en äldre klient skulle anropa dig. Då upptäcks oavsiktliga brytningar som typkontrollen inte kan se.
Snabb kontroll
Vilken ändring i ett befintligt verktyg är säker för nuvarande klienter?
Sammanfattning: utvecklas säkert
Föredra additiva ändringar, markera sådant som föråldrat innan du tar bort det, leverera v2 vid verkliga brytande ändringar, följ semver och för en ändringslogg. Då kan du lansera med förtroende! 🚀
Lär dig Python med en AI-lärare – gratis
Skriv och kör riktig kod i webbläsaren, få omedelbar hjälp av en AI-lärare dygnet runt och fortsätt där du slutade – på webben eller i appen.
- Kurser
- 30
- Lektioner
- 120
Vanliga frågor
Är lektionen ”Versionshantera verktyg och scheman” gratis?
Ja – du kan läsa vilka 3 lektioner som helst i lärvägen MCP Academy, inklusive ”Versionshantera verktyg och scheman”, kostnadsfritt i sin helhet här på webben. Därefter låser CoddyKit PRO upp alla lektioner, plus interaktiv övning med en inbyggd kodredigerare och en AI-lärare dygnet runt. Kursen i MCP Academy innehåller totalt 4 lektioner.
Vad lär jag mig i ”Versionshantera verktyg och scheman”?
Vidareutveckla servern utan att bryta klienterna. Ni övar på MCP Academy med praktisk kod som körs direkt i webbläsaren, medan en AI-handledare som är tillgänglig dygnet runt svarar på Era frågor under lektionen.
Behöver jag någon erfarenhet för att börja lära mig MCP Academy?
Du behöver inga förkunskaper. Utbildningen i MCP Academy på CoddyKit är upplagd för allt från nybörjare till avancerade elever, så att du kan börja här eller från början och gå fram i din egen takt. Detta är lektion 4 av 4.
Hur lång tid tar lektionen ”Versionshantera verktyg och scheman”?
De flesta CoddyKit-lektioner tar cirka 5–10 minuter. Varje lektion är kort och interaktiv, så att du gör stadiga framsteg och kan fortsätta precis där du slutade – på webben eller i appen.
Kan jag skriva och köra kod i den här MCP Academy-lektionen?
Ja. Varje MCP Academy-lektion innehåller en inbyggd kodredigerare, så att du kan skriva och köra riktig kod direkt i webbläsaren och få omedelbar AI-feedback – utan lokal installation.
Alla lektioner i den här kursen
- Lagerindelad serverarkitektur
- Konfiguration och hemligheter via miljön
- Idempotenta verktyg med medvetenhet om sidoeffekter
- Versionshantera verktyg och scheman