Skip to main content

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

Release files for vicsia-system-mcp 1.3.16

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.16
File Size Uploaded
vicsia_system_mcp-1.3.16.tar.gz 30.4 kB Details

Built distribution (wheel)

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

Total release size: 66.5 kB

Release files / vicsia_system_mcp-1.3.16.tar.gz

Download URL vicsia_system_mcp-1.3.16.tar.gz
Size 30.4 kB
Tags Source
SHA-256 checksum
How to use checksums
9c9ee4bd46e17a24e1f476ebe141eedbefa339045e5d7a4cf5d5c7299631ae0e
BLAKE2b-256 checksum
How to use checksums
d23386b735c20c42c399a598ed086a2f6b6fa2adffc216b619e450d0a309f7c1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.19 {"installer":{"name":"uv","version":"0.12.19","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.16-py3-none-any.whl

Download URL vicsia_system_mcp-1.3.16-py3-none-any.whl
Size 36.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b2ab0351a65bae476f5a3b526ba7c35423af114853be30f9fe4d984e7486e984
BLAKE2b-256 checksum
How to use checksums
bf07f417b117056ca7d2207808de969c5d5f0ef1e5468637d219accc6279eb42
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.19 {"installer":{"name":"uv","version":"0.12.19","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 history Release notifications | RSS feed

This release

1.3.16 This release

2 release files

1.3.15

2 release files

1.3.14

2 release files

1.3.13

2 release files

1.3.9

2 release files

1.3.8

2 release files

1.3.7

2 release files

1.3.6

2 release files

1.3.5

2 release files

1.3.4

2 release files

1.3.3

2 release files

1.3.2

2 release files

1.3.1

2 release files

1.3.0

2 release files

1.2.8

2 release files

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