Which integrations are available for this server?

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.

How do I use osascript MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@osascript MCP Server Get 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 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

osascript MCP Server

osascript MCP Server

特徴

インストール

方法 1: MCPB ファイルから（推奨）

方法 2: 手動設定

使用方法

AppleScript の実行

JXA（JavaScript）の実行

許可される操作

シェルコマンド（削除以外）

Finder 操作

System Events

アプリケーション制御

ブロックされる操作

シェルでの削除

Finder での削除

設定オプション

開発

ビルド

テスト

セキュリティ

ライセンス

関連リンク

Resources

Tools

New MCP Servers

Latest Blog Posts

MCP directory API