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 disk
JXA（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 home
System 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
設定オプション
| オプション | 説明 | デフォルト |
|---|---|---|
timeout | スクリプト実行タイムアウト（ミリ秒） | 30000 |
log_scripts | スクリプトをログ出力するか | 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