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 (
open_app) avec fuzzy match du nom - Ouvrir un chemin / fichier (
open_path) avec garde-fous sécurité - Lister les documents récents (
documents_recents) — ouverts ou modifiés ces 30 derniers jours, groupés par dossier (Recent.lnksur Windows, Spotlight sur macOS) - Chercher un nom (
find_files) dans les ~20 dossiers actifs seulement — jamais tout le disque ; « pas trouvé » signifie « pas dans les dossiers actifs », et le dit - Récupérer des infos système (
system_info: batterie, wifi, micro) - Ouvrir des panneaux de réglages (
open_settings,list_settings_panels)
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
1 maintainer
Release files for vicsia-system-mcp 1.3.14
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| vicsia_system_mcp-1.3.14.tar.gz | 30.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| vicsia_system_mcp-1.3.14-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 66.5 kB
Release files / vicsia_system_mcp-1.3.14.tar.gz
| Download URL | vicsia_system_mcp-1.3.14.tar.gz |
|---|---|
| Size | 30.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
1f43b8e709c9ecec3cf871342bc0e23ac6d956ee1ddf22e99cddb0bb0a6cb59b
|
|
BLAKE2b-256 checksum How to use checksums |
10bec34f9bf1d98995ba61700662fc5d542a8abb98d4d5e192f5736ab5535fa6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.15 {"installer":{"name":"uv","version":"0.12.15","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}
|
Release files / vicsia_system_mcp-1.3.14-py3-none-any.whl
| Download URL | vicsia_system_mcp-1.3.14-py3-none-any.whl |
|---|---|
| Size | 36.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
183b6862087f00c6148babec43b0131a97c6d115dd184edf1a7cc7834803bd0d
|
|
BLAKE2b-256 checksum How to use checksums |
78b499fc1d66df7c76aa80087b7cc3bed94270cbbec63248e3be9973f516d38e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.15 {"installer":{"name":"uv","version":"0.12.15","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}
|
