Skip to main content
Glama
MomoSGM

Local File System MCP Server

by MomoSGM
README.md
# mon_serveur_mcp

Serveur MCP local exposant deux outils :

- `disk_usage(path)` — taille totale d'un dossier (info système)
- `find_files(directory, keyword)` — recherche de fichiers par mot-clé (outil personnel)

## Installation (macOS)

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

## Vérifier que le serveur démarre

```bash
python server.py
```

(Le serveur attend des messages sur l'entrée standard : il semble "ne rien
faire", c'est normal. Aucune erreur = démarrage OK. Ctrl+C pour quitter.)

## Brancher dans Claude Desktop

Éditer le fichier :
`~/Library/Application Support/Claude/claude_desktop_config.json`

```json
{
  "mcpServers": {
    "mon-serveur": {
      "command": "/CHEMIN/ABSOLU/mon_serveur_mcp/.venv/bin/python",
      "args": ["/CHEMIN/ABSOLU/mon_serveur_mcp/server.py"]
    }
  }
}
```

IMPORTANT : `command` doit pointer vers le **python du venv** (où `mcp`
est installé), pas vers un `python` générique — sinon Claude Desktop ne
trouvera pas le module `mcp`.

Puis quitter complètement Claude Desktop (Cmd+Q) et le relancer.

TDQS

B3.2/5.0

Scored across 2 tools

Disambiguation5/5

Both tools have clearly distinct purposes: one calculates folder size, the other searches for files by name. There is no overlap or ambiguity.

Naming Consistency4/5

Both use snake_case, but disk_usage is noun_noun while find_files is verb_noun, showing a minor inconsistency in pattern.

Tool Count2/5

Only 2 tools for a file system server is too few; essential operations like listing, reading, writing, deleting files are missing, making the tool set feel incomplete.

Completeness2/5

The tools cover only disk usage and file search, leaving out basic file CRUD operations, which are necessary for a file system utility.

Maintenance

ActivityInactive
ResponsivenessNo issues