𝗠𝗼𝗱𝗲𝗹 𝗖𝗼𝗻𝘁𝗲𝘅𝘁 𝗣𝗿𝗼𝘁𝗼𝗰𝗼𝗹 𝗘𝘅𝗽𝗹𝗮𝗶𝗻𝗲𝗱

Acha kuandika kodi ile ile ya uunganishaji (integration) mara kwa mara.

Ukikiunganisha LLM kwenye kanzi data (database) au API, mara nyingi huandika kodi maalum ya kiunganishi (glue code) kwa kila modeli mpya. Hii inaleta vurugu. Unajikuta unasimamia miunganisho mingi kwa ajili ya zana nyingi.

Model Context Protocol (MCP) inatatua hili. Inafanya kazi kama port ya USB-C kwa ajili ya AI. Unatengeneza zana mara moja, na modeli yoyote inaweza kuitumia.

Muundo huu una sehemu tatu:

• Host: Programu unayotumia, kama Claude Code au IDE. • Client: Kiunganishi kilicho ndani ya host. • Server: Programu unayotengeneza ili kutoa data au zana.

Unaweza kutengeneza MCP server kwa kutumia misingi mikuu mitatu:

  • Tools: Kazi (functions) ambazo modeli huita ili kufanya kazi, kama kutuma barua pepe.
  • Resources: Data za kusoma tu ambazo programu huzichukua, kama faili la log.
  • Prompts: Vipengele (templates) vinavyoweza kutumika tena kwa kazi maalum.

Hivi ndivyo unavyoweza kutengeneza server ya msingi kwa Python ukitumia FastMCP SDK:

from mcp.server.fastmcp import FastMCP

mcp = FastMCP("demo-tools")

@mcp.tool()
def word_count(text: str) -> int:
    """Count words in a text."""
    return len(text.split())

@mcp.resource("notes://team")
def team_notes() -> str:
    """Expose team notes."""
    return "Release freeze starts Friday."

@mcp.prompt()
def code_review(language: str, code: str) -> str:
    """Template for code reviews."""
    return f"Review this {language} code: {code}"

if __name__ == "__main__":
    mcp.run()

Kodi hii inashughulikia mawasiliano magumu kwa niaba yako. Docstrings zako zinakuwa maelekezo kwa modeli.

Vidokezo vitatu kwa ajili ya matumizi ya kibiashara (production):

  1. Usalama: Omba idhini ya mtumiaji kila wakati kabla ya kuendesha zana inayobadilisha data.
  2. Muktadha: Fanya maelezo ya zana yawe mafupi. Maelezo marefu yanapoteza tokeni.
  3. Makosa: Toa ujumbe ulio wazi. Modeli inaweza kurekebisha kosa la "User not found", lakini haiwezi kurekebisha hitilafu ya kodi (code crash).

Acha kutengeneza viunganishi maalum (bespoke connectors). Tengeneza MCP server mara moja na uiruhusu kila modeli kuitumia.

Source: https://dev.to/galian/model-context-protocol-explained-build-your-first-mcp-server-in-python-ian