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 提供了一个交互式 Web 控制台,用于测试和验证 MCP 客户端实现。

主要特性

  • 🔍 协议消息检查 - 实时查看所有 MCP JSON-RPC 消息
  • 🧠 采样测试 - 测试客户端 LLM 补全能力
  • ❓ 引导测试 - 测试客户端用户输入请求处理
  • 🔔 通知测试 - 触发并验证列表变更通知
  • 🛠️ 检查器工具 - 六个用于测试场景的实用工具
  • 📊 多客户端支持 - 同时测试多个客户端(HTTP 模式)
  • 🌐 Web 控制台 - 用于测试的交互式 Fresh UI

快速开始

直接从 JSR 运行 - 无需安装:

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

这将在端口 3000 上启动 MCP 服务器,并在端口 8000 上启动 Web 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 服务器了吗?

立即使用我们的开源库开始构建,或与我们讨论为您的业务量身定制的解决方案。