AppleScript BB MCP Server

官方

讓 LLM 客戶端能透過 AppleScript 與 macOS 應用程式互動。此伺服器使用 @beyondbetter/bb-mcp-server 函式庫建置,提供安全、受控的預定義腳本執行,並可選擇支援任意腳本執行。

你可以用 AppleScript BB MCP 做什麼?

  • 執行 AppleScript — 直接從 AI 對話中執行 AppleScript 程式碼,以控制 macOS 應用程式並自動化任務。
  • 讀取應用程式字典 — 透過應用程式的字典,探索其支援的 AppleScript 指令與物件。
  • 自動化 Finder — 透過 Finder 整合來管理檔案、設定標籤、取得選取項目,並整理檔案系統。
  • 管理自動化權限 — 檢查並管理伺服器的 AppleScript 自動化存取權限。

文件

生產就緒的 MCP 工具

使用我們歷經實戰考驗的開源函式庫,建置企業級 MCP 伺服器。從生產系統中萃取,專為真實世界使用而設計。

什麼是 Model Context Protocol?

MCP 是一個開放協定,讓 AI 應用程式能安全地連線至資料來源與工具。可將其視為 AI 系統的通用連接器。

為什麼 MCP 對您的業務很重要

通用整合

使用標準化協定,將任何 AI 應用程式連線至您的業務工具與資料來源。

面向未來

只需建置一次,即可隨著生態系統成長,用於任何相容 MCP 的 AI 應用程式。

安全設計

內建安全功能在啟用強大整合的同時,保護您的資料。

快速開發

善用現有函式庫與模式,快速建置自訂整合。

BB MCP Server:生產就緒的 MCP 函式庫

一個全面的 Deno 架構,用於建置企業級 MCP 伺服器

為什麼選擇 BB MCP Server

  • 快速開發: 具備自動探索功能的插件系統,讓您立即上手
  • 企業就緒: 內建 OAuth、雙傳輸支援,以及用於生產部署的持久化儲存
  • 型別安全: 完整的 TypeScript 支援與嚴格的驗證,可減少錯誤並提升可維護性
  • 實戰考驗: 從服務真實企業的生產 MCP 伺服器中萃取

技術功能

  • ✓ 具備自動探索與載入功能的插件系統
  • ✓ 用於第三方整合的 OAuth 提供者與消費者
  • ✓ 具備工作階段管理的 STDIO 與 HTTP 傳輸
  • ✓ 基於 Deno KV 的儲存,具備自動清理與分塊功能
  • ✓ 具備稽核軌跡與結構化輸出的全面日誌記錄
  • ✓ 完整的 TypeScript 與嚴格的型別檢查
  • ✓ 廣泛的測試工具與範例
  • ✓ 已發布至 JSR 註冊表,便於安裝

快速入門

此函式庫包含 4 個漸進式範例,從基礎工具到進階 OAuth 整合,逐步教導您一切所需:

⭐ 簡易 MCP 伺服器

具備公用工具與插件探索的基本設定

⭐⭐ 插件工作流程

適用於複雜業務邏輯的多步驟工作流程

⭐⭐⭐ API 與 OAuth

具備驗證的第三方 API 整合

⭐⭐⭐⭐ 手動相依性

適用於進階使用案例的完整基礎設施控制

BB MCP Client Inspector

一個全面的 MCP 用戶端實作測試平台

它的功能

雖然 MCP Inspector 作為測試伺服器的 MCP 用戶端存在,但此工具填補了相反的需求——一個用於測試用戶端的 MCP 伺服器。BB MCP Client Inspector 提供一個互動式網頁主控台,用於測試與驗證 MCP 用戶端實作。

主要功能

  • 🔍 協定訊息檢查 - 即時檢視所有 MCP JSON-RPC 訊息
  • 🧠 取樣測試 - 測試用戶端 LLM 完成能力
  • ❓ 誘發測試 - 測試用戶端使用者輸入請求處理
  • 🔔 通知測試 - 觸發並驗證清單變更通知
  • 🛠️ 檢查工具 - 六個用於測試情境的公用工具
  • 📊 多用戶端支援 - 同時測試多個用戶端(HTTP 模式)
  • 🌐 網頁主控台 - 互動式 Fresh UI 用於測試

快速開始

直接從 JSR 執行 - 無需安裝:

deno run -A jsr:@beyondbetter/bb-mcp-client-inspector

這會在連接埠 3000 啟動 MCP 伺服器,並在連接埠 8000 啟動網頁 UI。

使用案例

MCP 用戶端開發

在受控環境中測試取樣、誘發與通知處理,以驗證您的 MCP 用戶端實作。

協定除錯

即時檢查所有 JSON-RPC 訊息,以除錯用戶端與伺服器之間的通訊問題。

整合測試

在 HTTP 模式下同時測試多個用戶端,以驗證不同實作之間的行為一致性。

檢查工具

六個用於全面測試的公用工具:

  • ✓ echo - 訊息回顯,可選延遲與轉換
  • ✓ convert_date - 日期/時區轉換與格式化
  • ✓ calculate - 基本算術運算
  • ✓ delay_response - 可設定的延遲,用於逾時測試
  • ✓ random_data - 產生隨機測試資料
  • ✓ trigger_error - 故意觸發錯誤,用於錯誤處理測試

BB AppleScript MCP Server

透過 MCP 使用 AppleScript 自動化,擴展 macOS 工作流程

它的功能

一個生產就緒的 MCP 伺服器,將 AppleScript 自動化帶入任何相容 MCP 的 AI 應用程式。使用 BB MCP Server 建置,作為您可以使用此函式庫建立內容的真實世界範例。

主要能力

  • 從 AI 對話中執行 AppleScript 程式碼
  • 讀取應用程式字典以探索能力
  • 透過 Finder 整合自動化檔案管理
  • 管理權限並檢查自動化存取

Claude Desktop 快速設定

將此內容新增至您的 Claude Desktop 設定:

{
  "mcpServers": {
    "bb-applescript": {
      "command": "deno",
      "args": [
        "run",
        "--allow-all",
        "--unstable-kv",
        "jsr:@beyondbetter/bb-applescript-mcp-server"
      ]
    }
  }
}

完整文件

使用案例

開發者工作流程

透過 AI 對話自動化 BBEdit 專案、操作檔案,並與開發工具整合。

檔案管理

使用自然語言整理檔案、設定標籤、擷取選取項目,並管理您的檔案系統。

應用程式自動化

透過您的 AI 助理控制支援 AppleScript 的 macOS 應用程式。

準備好建置您自己的 MCP 伺服器了嗎?

立即使用我們的開源函式庫開始,或與我們討論為您的業務量身打造的自訂解決方案。