Pre-release
This release is a pre-release and may not be stable for production use.
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.14b2
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.14b2.tar.gz | 30.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| vicsia_system_mcp-1.3.14b2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 66.6 kB
Release files / vicsia_system_mcp-1.3.14b2.tar.gz
| Download URL | vicsia_system_mcp-1.3.14b2.tar.gz |
|---|---|
| Size | 30.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
027d43da649790570bb0fd69d0217dc116c6c66acbf0f82207b27bfaf73949fe
|
|
BLAKE2b-256 checksum How to use checksums |
5ea31efe4186c9977d4f5169623c412f4d6f2e0324d688169fe11c912c03c037
|
| 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.14b2-py3-none-any.whl
| Download URL | vicsia_system_mcp-1.3.14b2-py3-none-any.whl |
|---|---|
| Size | 36.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ad7edb5d4e17e6f3c3322eef8aa44e83ad4d032bf7ba7ca5023497f937ed90ba
|
|
BLAKE2b-256 checksum How to use checksums |
a9cd32eea8295b5237a08c17294a7c634d99e51caa2f02050d4d6952335b0b50
|
| 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}
|
