Un serveur MCP

"""Un serveur MCP en lecture seule sur deux fichiers de l'entreprise : les clients et les factures.
Données fabriquées. Rien ne s'écrit ; rien ne sort sur stdout, réservé au protocole."""
import csv
import logging
from datetime import date
from pathlib import Path
from typing import TypedDict

from mcp.server import MCPServer
from mcp.server.mcpserver.exceptions import ToolError

ICI = Path(__file__).parent
logging.basicConfig(level=logging.INFO)  # les journaux vont sur stderr
mcp = MCPServer("Suivi clients")

class Fiche(TypedDict):
    client: str
    ville: str
    contact: str
    encours_eur: str

def _lire(nom: str) -> list[dict]:
    with open(ICI / nom, encoding="utf-8", newline="") as f:
        return list(csv.DictReader(f, delimiter=";"))

@mcp.tool()
def chercher_client(nom: str) -> Fiche:
    """Donne la fiche d'un client : ville, contact, encours.

    Args:
        nom: Le nom exact du client, par exemple Société A.
    """
    for ligne in _lire("clients.csv"):
        if ligne["client"] == nom:
            return ligne
    raise ToolError(f"Aucun client nommé {nom}.")  # le message part au modèle, sans trace

@mcp.tool()
def factures_en_retard(au: str = "") -> list[dict]:
    """Liste les factures non payées dont l'échéance est passée.

    Args:
        au: La date de référence, au format AAAA-MM-JJ ; par défaut, aujourd'hui.
    """
    try:
        jour = date.fromisoformat(au) if au else date.today()
    except ValueError:
        raise ToolError("Date attendue au format AAAA-MM-JJ.")
    return [f for f in _lire("factures.csv")
            if f["payee"] == "non" and date.fromisoformat(f["echeance"]) < jour]

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

"""Lance le serveur comme le ferait un assistant, sur stdio, et appelle ses deux outils. Aucun modèle."""
import asyncio
import sys

from mcp import Client, StdioServerParameters

async def main() -> None:
    serveur = StdioServerParameters(command=sys.executable, args=["serveur.py"])
    async with Client(serveur) as client:
        outils = await client.list_tools()
        print("Outils :", ", ".join(o.name for o in outils.tools))
        fiche = await client.call_tool("chercher_client", {"nom": "Société B"})
        f = fiche.structured_content
        print(f"Société B : {f['ville']}, {f['contact']}, encours {f['encours_eur']} €")
        inconnu = await client.call_tool("chercher_client", {"nom": "Société Z"})
        print("Société Z :", inconnu.content[0].text if inconnu.is_error else "trouvée")
        retards = await client.call_tool("factures_en_retard", {"au": "2026-10-09"})
        print("En retard au 9 octobre 2026 :")
        for r in retards.structured_content["result"]:
            print(f"  {r['numero']}, {r['client']}, {r['montant_eur']} €, échue le {r['echeance']}")

asyncio.run(main())

{
  "mcpServers": {
    "suivi-clients": {
      "command": "uv",
      "args": [
        "--directory",
        "/CHEMIN/ABSOLU/suivi-clients",
        "run",
        "serveur.py"
      ]
    }
  }
}