AppleScript MCP sunucusu
Bir AI istemcisinin Mac üzerinde AppleScript çalıştırarak uygulamaları, dosyaları, hatırlatıcıları, takvimleri, mesajları ve kabuk komutlarını kontrol etmesini sağlar.
Ayrıca bilinen adı peakmojo/applescript-mcp, @peakmojo/applescript-mcp
- Yıldızlar
- 468
- Araçlar
- —
- İndirmeler, 30 gün
- —
- En son sürüm
- —
- Son commit
- 22 Şub 2026
- Lisans
- MIT
AppleScript MCP nedir?
AppleScript bir MCP sunucusudur. Bir AI istemcisinin Mac üzerinde AppleScript çalıştırarak uygulamaları, dosyaları, hatırlatıcıları, takvimleri, mesajları ve kabuk komutlarını kontrol etmesini sağlar.
Özet, projenin README dosyasından oluşturuldu
AppleScript MCP sunucusu hakkında
Bu MCP server ile macOS uygulamalarını ve sistem verilerini bir AI istemcisi üzerinden kontrol etmek mümkündür. Kullanıcıların dosyaları, hatırlatıcıları, takvimleri, mesajları ve notları doğrudan sohbet arayüzlerinden yönetmek için AppleScript çalıştırmasına olanak tanır. Dil modelleri ile Mac işletim sistemi arasındaki boşluğu doldurarak Apple Music, Safari ve Kişiler gibi yerel uygulamalarla otomatik etkileşim kurulmasını sağlar.
Geliştiriciler bu kurulumu Node.js kullanarak npx ile veya Python kullanarak uvx ile yerel olarak yapabilirler. Docker konteynerleri içinde çalışanlar için server, ana makineye bağlanarak SSH üzerinden uzaktan yürütmeyi destekler. Bu kurulum, Mac sistem ayarlarınızda Uzaktan Oturum Açma (Remote Login) özelliğinin etkinleştirilmesini ve gerekli kullanıcı bilgilerinin sağlanmasını gerektirir. Server; pil yüzdesini kontrol etmek, Spotlight ile dosya aramak veya kabuk komutları çalıştırmak gibi sistem görevlerini yerine getirmek için bir yol sunar.
Neler yapabilirsiniz
- 1Kişisel programları ve görevleri yönetinAI'dan takviminize yeni toplantılar eklemesini veya belirli hatırlatıcılar oluşturmasını isteyin.
- 2Yerel dosyaları düzenleyin ve arayınAI'dan klasörlerinizdeki belirli dosyaları bulmasını veya masaüstünüzde yeni dizinler oluşturmasını talep edin.
- 3Medya ve sistem ayarlarını kontrol edinAI'ya belirli müzik çalma listelerini oynatması veya donanım durumunuzu kontrol etmesi talimatını verin.
- 4İletişimi ve kişi bilgilerini getirmeyi otomatize edinKişilerinizdeki telefon numaralarını bulmak veya okunmamış mesajları kontrol etmek için AI'yı kullanın.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
AppleScript MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıCursor'a ekleGoose'a ekleAppleScript MCP'yi Claude Code içine yükleyin
$ claude mcp add applescript-mcp -- npx -y @peakmojo/applescript-mcpAppleScript MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"applescript-mcp": {
"command": "npx",
"args": [
"-y",
"@peakmojo/applescript-mcp"
]
}
}
}AppleScript MCP'yi VS Code içine yükleyin
.vscode/mcp.json
{
"servers": {
"applescript-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@peakmojo/applescript-mcp"
]
}
}
}AppleScript MCP'yi VS Code CLI içine yükleyin
$ code --add-mcp '{"name":"applescript-mcp","type":"stdio","command":"npx","args":["-y","@peakmojo/applescript-mcp"]}'AppleScript MCP'yi Claude Desktop içine yükleyin
claude_desktop_config.json
{
"mcpServers": {
"applescript-mcp": {
"command": "npx",
"args": [
"-y",
"@peakmojo/applescript-mcp"
]
}
}
}AppleScript MCP'yi Codex içine yükleyin
$ codex mcp add applescript-mcp -- npx -y @peakmojo/applescript-mcpAppleScript MCP'yi Codex config.toml içine yükleyin
~/.codex/config.toml
[mcp_servers.applescript-mcp] command = "npx" args = ["-y", "@peakmojo/applescript-mcp"]
AppleScript MCP'yi Gemini CLI içine yükleyin
$ gemini mcp add -s user applescript-mcp npx -- -y @peakmojo/applescript-mcpAppleScript MCP'yi Gemini settings.json içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"applescript-mcp": {
"command": "npx",
"args": [
"-y",
"@peakmojo/applescript-mcp"
]
}
}
}Otomatik kontroller
Çalıştırıldı 14 Kas 2026Tam rapor →Henüz doğrulanmadı. Bir sunucunun 80 puana, ciddi bir bulgu olmamasına ve kontrol edebilmemiz için yeterli veriye ihtiyacı vardır. Kontroller nasıl çalışır · Daha fazla puan için nelerin düzeltileceği
- Kaynak deposu bağlantılı ve erişilebilirpeakmojo/applescript-mcp is public and reachablegithub.com/peakmojo/applescript-mcp ↗Geçti
- Paket, bu depoyu kaynağı olarak gösteriyor@peakmojo/applescript-mcp names peakmojo/applescript-mcp as sourcenpmjs.com/package/@peakmojo/applescript-mcp ↗Geçti
- Derleme kökeni (Sigstore onayı)No build attestation published for this releaseKontrol edilmedi
- Açık kaynak lisansı (OSI)MITspdx.org/licenses/MIT.html ↗Geçti
- Son bir yıl içinde commit veya sürüm mevcutLast commit or release 2026-02-22github.com/peakmojo/applescript-mcp ↗Geçti
- OpenSSF ScorecardKontrol edilmedi
- Paket adı popüler bir pakete yakın değilNo popular package one edit away from @peakmojo/applescript-mcpGeçti
- Pakette veya bağımlılıklarında kritik uyarı yokKontrol edilmedi
- Modele yönelik gizli talimat yok0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersGeçti
- Yıkıcı araçlar etiketlenmişKontrol edilmedi
- Uzak uç nokta MCP el sıkışmasına yanıt veriyorKontrol edilmedi
AppleScript MCP Server (Dual access: python and node.js)
Overview
A Model Context Protocol (MCP) server that lets you run AppleScript code to interact with Mac. This MCP is intentionally designed to be simple, straightforward, intuitive, and require minimal setup.
I can't believe how simple and powerful it is. The core code is <100 line of code.
https://github.com/user-attachments/assets/b85e63ba-fb26-4918-8e6d-2377254ee388
Features
- Run AppleScript to access Mac applications and data
- Interact with Notes, Calendar, Contacts, Messages, and more
- Search for files using Spotlight or Finder
- Read/write file contents and execute shell commands
- Remote execution support via SSH
Example Prompts
Create a reminder for me to call John tomorrow at 10am
Add a new meeting to my calendar for Friday from 2-3pm titled "Team Review"
Create a new note titled "Meeting Minutes" with today's date
Show me all files in my Downloads folder from the past week
What's my current battery percentage?
Show me the most recent unread emails in my inbox
List all the currently running applications on my Mac
Play my "Focus" playlist in Apple Music
Take a screenshot of my entire screen and save it to my Desktop
Find John Smith in my contacts and show me his phone number
Create a folder on my Desktop named "Project Files"
Open Safari and navigate to apple.com
Tell me how much free space I have on my main drive
List all my upcoming calendar events for this week
Usage with Claude Desktop
Node.js
{
"mcpServers": {
"applescript_execute": {
"command": "npx",
"args": [
"@peakmojo/applescript-mcp"
]
}
}
}
Python (uvx)
No clone needed — run directly from the git repo:
{
"mcpServers": {
"applescript_execute": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/peakmojo/applescript-mcp",
"mcp-server-applescript"
]
}
}
}
Python (local development)
For local development, clone the repo and use uv to run from source:
brew install uv
git clone https://github.com/peakmojo/applescript-mcp.git
{
"mcpServers": {
"applescript_execute": {
"command": "uv",
"args": [
"--directory",
"/path/to/your/repo",
"run",
"mcp-server-applescript"
]
}
}
}
Development
Setup
brew install uv
uv sync --dev
Run all checks (in parallel)
uv run check
This runs linting, formatting, type checking, and tests with 100% coverage — all in parallel.
Individual commands
uv run lint # ruff linter
uv run format # ruff auto-format
uv run typecheck # pyrefly type checker
uv run test # pytest with 100% coverage enforcement
Docker Usage
When running in a Docker container, you can use the special hostname host.docker.internal to connect to your Mac host:
Configuration
{
"mcpServers": {
"applescript_execute": {
"command": "npx",
"args": [
"@peakmojo/applescript-mcp",
"--remoteHost", "host.docker.internal",
"--remoteUser", "yourusername",
"--remotePassword", "yourpassword"
]
}
}
}
This allows your Docker container to execute AppleScript on the Mac host system. Make sure:
- SSH is enabled on your Mac (System Settings → Sharing → Remote Login)
- Your user has proper permissions
- The correct credentials are provided in the config
AppleScript MCP soruları
AppleScript MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add applescript-mcp -- npx -y @peakmojo/applescript-mcp komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
AppleScript MCP'yi Cursor'a nasıl eklerim?
~/.cursor/mcp.json dosyasını açın ve yukarıdaki yükleme bölümünde gösterilen Cursor yapılandırmasını kullanarak sunucuyu mcpServers altına ekleyin.
Mac'imde AppleScript MCP server ile neler yapabilirim?
Notlar, Takvim, Kişiler, Mesajlar, dosyalar ve kabuk komutları dahil olmak üzere Mac uygulamaları ve verileriyle etkileşime girmek için AppleScript kodlarını çalıştırır.
AppleScript MCP server'ı Claude Desktop ile nasıl kurarım?
@peakmojo/applescript-mcp paketini npx kullanarak bir MCP server olarak ekleyebilir veya Python versiyonunu git reposundan uvx ile çalıştırabilirsiniz.
Docker konteyneri içinden çalışabilir mi?
Evet, Mac üzerinde SSH etkinleştirilmişse host.docker.internal hostname kullanımı ile birlikte uzak host, kullanıcı ve şifre argümanlarını kullanarak çalışabilir.
Uzaktan yürütmeyi destekliyor mu?
Evet, uzak host, kullanıcı ve şifre ile SSH üzerinden uzaktan yürütme desteklenmektedir.
Python versiyonu hangi komut satırı aracına ihtiyaç duyar?
Python versiyonu, Homebrew ile kurulabilen uv aracılığıyla çalışır.