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.14b1
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.14b1.tar.gz | 30.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| vicsia_system_mcp-1.3.14b1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 66.6 kB
Release files / vicsia_system_mcp-1.3.14b1.tar.gz
| Download URL | vicsia_system_mcp-1.3.14b1.tar.gz |
|---|---|
| Size | 30.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
650b6adbadd836269e5ff47152cb15133c961ddcb2b722ef8f2ecf30bab51bd8
|
|
BLAKE2b-256 checksum How to use checksums |
fded4812fd0153292aa33a50b5a26ce877f0aab71ef60ee2063c3b25321854e7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.13 {"installer":{"name":"uv","version":"0.12.13","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.14b1-py3-none-any.whl
| Download URL | vicsia_system_mcp-1.3.14b1-py3-none-any.whl |
|---|---|
| Size | 36.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
676fb1e2ed8e8fab1e93250350b81c647c285c768393c44b66706583d901dc08
|
|
BLAKE2b-256 checksum How to use checksums |
5a7658e08b2c5ca611a79e8cf2e18ae18af2601db2f0c5eb029bdd4d81e59b5d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.13 {"installer":{"name":"uv","version":"0.12.13","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}
|
