Provides programmatic control over the Apple application ecosystem, including native apps like Music, Calendar, and Safari via AppleScript and JXA.
Facilitates the execution of curl commands via shell scripts to interact with web APIs and remote servers.
Supports JavaScript for Automation (JXA), allowing the use of JavaScript to control macOS applications and system resources.
Allows for the automation of macOS system tasks, including file management via Finder and simulating user input through System Events.
Enables scripted interaction with the Safari browser to perform tasks such as retrieving the URL of the current active tab.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@osascript MCP ServerGet the URL and title of my active Safari tab"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
osascript MCP Server
macOS の osascript(AppleScript / JavaScript for Automation)を実行できる MCP サーバーです。
特徴
AppleScript サポート: macOS のネイティブ AppleScript を実行
JXA サポート: JavaScript for Automation(JXA)を実行
安全設計: ファイル削除コマンドのみブロック(その他は全て許可)
Desktop Extension 対応: .mcpb 形式でワンクリックインストール
インストール
方法 1: MCPB ファイルから(推奨)
.mcpbファイルをダウンロードClaude Desktop にドラッグ&ドロップ
インストールを許可
方法 2: 手動設定
Claude Desktop の設定ファイル(~/Library/Application Support/Claude/claude_desktop_config.json)に追加:
{
"mcpServers": {
"osascript": {
"command": "node",
"args": ["/path/to/osascript-mcp/server/index.js"],
"env": {
"OSASCRIPT_TIMEOUT": "30000",
"OSASCRIPT_LOG_SCRIPTS": "true"
}
}
}
}使用方法
AppleScript の実行
tell application "Finder" to get name of every diskJXA(JavaScript)の実行
Application("System Events").processes().map(p => p.name())許可される操作
以下の操作は全て許可されています:
シェルコマンド(削除以外)
do shell script "ls -la ~/Desktop"
do shell script "whoami"
do shell script "curl -s https://api.github.com"
do shell script "cat ~/.zshrc"Finder 操作
tell application "Finder" to get name of every disk
tell application "Finder" to get every file of desktop
tell application "Finder" to open folder "Documents" of homeSystem Events
tell application "System Events" to get name of every process
tell application "System Events" to keystroke "hello"
tell application "System Events" to key code 36 -- Enterアプリケーション制御
tell application "Safari" to get URL of current tab of window 1
tell application "Music" to get name of current track
tell application "Calendar" to get events of calendar 1ブロックされる操作
以下の削除操作のみがブロックされます:
シェルでの削除
-- これらはブロックされます
do shell script "rm test.txt"
do shell script "rm -rf ~/test"
do shell script "rmdir testdir"Finder での削除
-- これらはブロックされます
tell application "Finder" to delete file "test.txt" of desktop
move file "test.txt" to trash
empty trash設定オプション
オプション | 説明 | デフォルト |
| スクリプト実行タイムアウト(ミリ秒) | 30000 |
| スクリプトをログ出力するか | true |
開発
ビルド
# 依存関係インストール
npm install
# ローカルテスト
npm start
# MCPB パッケージ作成
npm install -g @anthropic-ai/mcpb
mcpb validate manifest.json
mcpb pack .テスト
# 許可されるスクリプトのテスト
echo 'tell application "Finder" to get name of every disk' | node server/index.js
# サーバーの直接実行(デバッグ用)
node server/index.jsセキュリティ
このサーバーは「最小限のセキュリティ」設計を採用しています:
✅ 許可: シェルコマンド(
ls,curl,catなど)✅ 許可: System Events(
keystroke,key code)✅ 許可: 全アプリケーションの制御
❌ ブロック:
rm,delete,trashなどの削除操作
より厳格なセキュリティが必要な場合は、server/index.js の BLOCKED_PATTERNS を編集してください。
ライセンス
MIT
関連リンク
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.