Metadata-Version: 2.4
Name: vicsia-system-mcp
Version: 1.2.8b24
Summary: MCP server for Vicsia — controle systeme par la voix (apps, paths, settings)
Project-URL: Homepage, https://github.com/TMDray/IAVocal
Project-URL: Repository, https://github.com/TMDray/IAVocal
License: MIT
Keywords: accessibility,claude,macos,mcp,system,voice,windows
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.11
Requires-Dist: mcp>=1.0.0
Description-Content-Type: text/markdown

# vicsia-system-mcp

MCP server pour piloter le système (macOS + Windows) depuis Claude ou tout autre client MCP — via Vicsia.

Expose des outils pour :
- **Lancer une application** (`launch_app`) avec fuzzy match du nom
- **Ouvrir un chemin / fichier** (`open_path`) avec garde-fous sécurité
- **Lister des fichiers** dans un scope défini (`list_files`)
- **Récupérer des infos système** (CPU, mémoire, batterie, écran)
- **Ouvrir des panneaux de réglages** (Display, Sound, Bluetooth, etc.)

## Installation

```bash
uvx vicsia-system-mcp
```

Ou avec pip :

```bash
pip install vicsia-system-mcp
python -m vicsia_system_mcp
```

## Configuration MCP client

```json
{
  "mcpServers": {
    "vicsia-system": {
      "command": "uvx",
      "args": ["vicsia-system-mcp"]
    }
  }
}
```

## Sécurité

- Aucun outil n'exécute du code arbitraire — seulement des commandes shell système via les API natives (`open` sur macOS, `start` sur Windows).
- `open_path` refuse les chemins contenant des segments sensibles (`.ssh`, `.aws`, `.kube`, credentials…) même si formulés explicitement.
- `list_files` est scopé : pas de `~` complet, uniquement les dossiers de contenu utilisateur (Documents, Desktop, Downloads, Pictures, Music, Movies/Videos).

## Licence

MIT
