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