zen-server-automation

Zen MCP Server Launcher

An automation suite for starting the Zen MCP Server on macOS.

Files

start-zen-server.zsh

A zsh script that:

• Checks for uvx availability
• Detects existing zen server processes
• Starts the Zen MCP Server using uvx
• Provides helpful status messages and error handling

Launch-Zen-Server.applescript

An AppleScript wrapper that:

• Opens Terminal
• Runs the zsh script with nice formatting
• Sets a custom window title
• Shows system notifications
• Brings Terminal to front

Installation

1. Make the zsh script executable:

   chmod +x "/Applications/Shell Scripts/zen-server/start-zen-server.zsh"
   

2. Test the zsh script directly:

   "/Applications/Shell Scripts/zen-server/start-zen-server.zsh"
   

3. Test the AppleScript:

   • Open Script Editor
   • Load Launch-Zen-Server.applescript
   • Click Run

Usage

Command Line

"/Applications/Shell Scripts/zen-server/start-zen-server.zsh"

AppleScript

• Double-click the .applescript file
• Or run from Script Editor
• Or compile to an Application for easier access

Requirements

• macOS with zsh
• uvx installed (curl -LsSf https://astral.sh/uv/install.sh | sh)
• Terminal access
• Zen MCP Server repository access

Features

• ✅ Process detection (prevents duplicate servers)
• ✅ Dependency checking (uvx availability)
• ✅ User-friendly output with emojis
• ✅ Error handling and status messages
• ✅ Terminal integration with custom titles
• ✅ System notifications
• ✅ Cross-platform path handling

Author

Created by Claude & Delmont for easy Zen MCP Server management.