# Serveur MCP — mon-serveur-mcp

Serveur [Model Context Protocol (MCP)](https://modelcontextprotocol.io) exposant des outils système et météo à un LLM compatible MCP (ex. Claude Desktop).

## Prérequis

- Python 3.12+
- `mcp` 1.27+

## Installation

```bash
python3 -m venv .venv
source .venv/bin/activate
pip install mcp
```

## Lancement

```bash
python server.py
```

Le serveur communique via **stdin/stdout** (protocole MCP over stdio).

## Outils disponibles

### `get_disk_usage`

Calcule la taille totale d'un dossier en mégaoctets.

| Paramètre | Type   | Description       |
|-----------|--------|-------------------|
| `path`    | string | Chemin du dossier |

**Exemple de réponse :** `142.3 Mo`

---

### `get_weather`

Retourne la météo actuelle d'une ville via l'API [Open-Meteo](https://open-meteo.com) (gratuite, sans clé API).

| Paramètre | Type   | Description     |
|-----------|--------|-----------------|
| `city`    | string | Nom de la ville |

**Exemple de réponse :** `Paris — 18.2°C, Partiellement nuageux, vent 14 km/h`

---

### `list_files`

Liste les fichiers et sous-dossiers d'un dossier local. Les dossiers sont affichés en premier (`[D]`), suivis des fichiers (`[F]`), triés alphabétiquement.

| Paramètre | Type   | Description       |
|-----------|--------|-------------------|
| `path`    | string | Chemin du dossier |

**Exemple de réponse :**

```text
[D] documents
[D] images
[F] README.md
[F] server.py
[F] tools.py
```

## Structure du projet

```text
.
├── server.py      # Serveur MCP : enregistrement des outils et point d'entrée
├── tools.py       # Implémentation des outils
└── pyproject.toml
```

## Intégration avec Claude Desktop

Ajouter dans `claude_desktop_config.json` :

```json
{
  "mcpServers": {
    "mon-serveur-mcp": {
      "command": "/chemin/vers/.venv/bin/python",
      "args": ["/chemin/vers/server.py"]
    }
  }
}
```