MCP server for Vicsia — controle systeme par la voix (apps, paths, settings)
Project description
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
uvx vicsia-system-mcp
Ou avec pip :
pip install vicsia-system-mcp
python -m vicsia_system_mcp
Configuration MCP client
{
"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 (
opensur macOS,startsur Windows). open_pathrefuse les chemins contenant des segments sensibles (.ssh,.aws,.kube, credentials…) même si formulés explicitement.list_filesest scopé : pas de~complet, uniquement les dossiers de contenu utilisateur (Documents, Desktop, Downloads, Pictures, Music, Movies/Videos).
Licence
MIT
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file vicsia_system_mcp-1.2.8b24.tar.gz.
File metadata
- Download URL: vicsia_system_mcp-1.2.8b24.tar.gz
- Upload date:
- Size: 11.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.16 {"installer":{"name":"uv","version":"0.11.16","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d9cd9eb5c6569519196e8b7be327b7b3decd8aa61d8022ad2448481d3916170f
|
|
| MD5 |
5b47ab5c7790cfeb06e85922aea88571
|
|
| BLAKE2b-256 |
0ea570c73b57ed2d8c72a142f05c5c854f54e4f0a0e7415477980167b1a7dce5
|
File details
Details for the file vicsia_system_mcp-1.2.8b24-py3-none-any.whl.
File metadata
- Download URL: vicsia_system_mcp-1.2.8b24-py3-none-any.whl
- Upload date:
- Size: 15.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.16 {"installer":{"name":"uv","version":"0.11.16","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
14afcdcf61fbc69854a32017972e434096664cbb637e1b79e047c96287fd605c
|
|
| MD5 |
5e17c4d23636093f79977d7b03555b06
|
|
| BLAKE2b-256 |
5f3e7c636c2af6394a63ba9d6edd97685311213ae7b01684dff7f9022ac3f6a8
|