Coyote MCP Server

# Coyote MCP Server A Model Context Protocol (MCP) server that enables AppleScript execution on macOS through the `run_applescript` tool. ## Quick Start ```bash git clone https://github.com/Sai-Adarsh/coyote-mcp-server.git cd coyote-mcp-server npm install npm run build npm run setup-claude-cli # or setup-claude, setup-vscode, setup-windsurf, setup-cursor ``` ## Usage Commands **Interactive Mode (Recommended):** ```bash claude --mcp-config ~/.config/claude-cli/mcp.json ``` Then type any command like: - `Use AppleScript to show a dialog with 'Hello World'` - `Use AppleScript to open Calculator` - `Use AppleScript to open Safari and go to google.com` **Quick Commands:** ```bash # Test the setup claude --mcp-config ~/.config/claude-cli/mcp.json --print "Use AppleScript to show a dialog with 'Hello World'" # Open applications claude --mcp-config ~/.config/claude-cli/mcp.json --print "Use AppleScript to open Calculator" claude --mcp-config ~/.config/claude-cli/mcp.json --print "Use AppleScript to open Safari" # Navigate websites claude --mcp-config ~/.config/claude-cli/mcp.json --print "Use AppleScript to open Safari and go to google.com" # Create notifications claude --mcp-config ~/.config/claude-cli/mcp.json --print "Use AppleScript to show a notification with title 'Test' and message 'Hello from MCP'" ``` **Note:** Claude CLI will ask for permission before executing AppleScript commands. Grant permission when prompted to allow automation. ## Quick Setup Commands | Client | Setup Command | |--------|---------------| | Claude CLI | `npm run setup-claude-cli` | | Claude Desktop | `npm run setup-claude` | | VS Code | `npm run setup-vscode` | | Windsurf | `npm run setup-windsurf` | | Cursor | `npm run setup-cursor` | | All clients | `npm run setup-all` | ## After Setup Once setup is complete, you'll see the MCP server listed as **`coyote-use`** in your client: - **Claude CLI/Desktop**: Server appears in MCP configuration - **VS Code**: Available in MCP extension as `coyote-use` - **Windsurf**: Available in Cascade → Plugins as `coyote-use` - **Cursor**: Server appears in MCP configuration as `coyote-use` The server provides the `run_applescript` tool for executing AppleScript commands on macOS. ## Uninstall To completely remove Coyote MCP Server and all configurations: ```bash npm run uninstall # or ./uninstall.sh ``` This will: - Remove `coyote-use` server from all MCP client configurations - Uninstall the global npm package - Clean up binary files from system PATH - Create backup copies of modified configurations - Clean npm cache and old backup files ## Troubleshooting **Command not found error after update:** ```bash hash -r ``` ## Development ```bash npm run build # Build the server npm start # Start manually for testing ``` ## References - [TypeScript MCP SDK](https://github.com/modelcontextprotocol/typescript-sdk) - [MCP Protocol Overview](https://modelcontextprotocol.io/docs/learn/architecture) - [Build an MCP Server](https://modelcontextprotocol.io/docs/develop/build-server)