Skip to main content
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 .lnk sur 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 (open sur macOS, start sur Windows).
  • open_path refuse les chemins contenant des segments sensibles (.ssh, .aws, .kube, credentials…) même si formulés explicitement.
  • list_files est scopé : pas de ~ complet, uniquement les dossiers de contenu utilisateur (Documents, Desktop, Downloads, Pictures, Music, Movies/Videos).

Licence

MIT

Metadata

Release files for vicsia-system-mcp 1.3.18b2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for vicsia-system-mcp 1.3.18b2
File Size Uploaded Provenance Actions
vicsia_system_mcp-1.3.18b2.tar.gz 36.2 kB Without provenance Details for vicsia_system_mcp-1.3.18b2.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for vicsia-system-mcp 1.3.18b2
File Interpreter ABI Platform Actions
vicsia_system_mcp-1.3.18b2-py3-none-any.whl Python 3 none any Details for vicsia_system_mcp-1.3.18b2-py3-none-any.whl

Total release size: 79.7 kB

Release files / vicsia_system_mcp-1.3.18b2.tar.gz

Download URL vicsia_system_mcp-1.3.18b2.tar.gz
Size 36.2 kB
Tags Source
SHA-256 checksum
How to use checksums
2236726e5a34f5d32b8b82d2b84a8fa10749a1cfef09525257704b02587ad70a
BLAKE2b-256 checksum
How to use checksums
3eb9d93d7ad5a85f91f555e1c7caa1ffd785dc2d9d67f06075b4aea8c2307240
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.5 {"installer":{"name":"uv","version":"0.13.5","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.18b2-py3-none-any.whl

Download URL vicsia_system_mcp-1.3.18b2-py3-none-any.whl
Size 43.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
caf64f884b4c3c721dc5e2d35a8f0cc4ebac512ad78d4273aab4f058d71f2664
BLAKE2b-256 checksum
How to use checksums
aea489a859b7541b99000669bd4a05e0e842f2d4d9c9e94da7d3535b4461ef85
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.5 {"installer":{"name":"uv","version":"0.13.5","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}

Security for vicsia-system-mcp 1.3.18b2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page