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.15b2
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.15b2.tar.gz | 30.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| vicsia_system_mcp-1.3.15b2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 66.6 kB
Release files / vicsia_system_mcp-1.3.15b2.tar.gz
| Download URL | vicsia_system_mcp-1.3.15b2.tar.gz |
|---|---|
| Size | 30.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
6550753b5e9a746440c9cc659ccbd23dcf548fdd6c569dcf63078a77d3fe1caa
|
|
BLAKE2b-256 checksum How to use checksums |
82782c0273e3e62755d8e8491e015dbab05cbfaf33376269d5fd90012b3e0d83
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.17 {"installer":{"name":"uv","version":"0.12.17","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.15b2-py3-none-any.whl
| Download URL | vicsia_system_mcp-1.3.15b2-py3-none-any.whl |
|---|---|
| Size | 36.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
b2c89ca7c4172776a4adc81715194e7bcd37378bc5959ab59085640c9c468a4f
|
|
BLAKE2b-256 checksum How to use checksums |
a5b6fd99757b298a5c2508bc89ef9bf237fc8c594284e01e4e04eeafb7ce317a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.17 {"installer":{"name":"uv","version":"0.12.17","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}
|
