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 服务器了吗?
立即使用我们的开源库开始构建,或与我们讨论为您的业务量身定制的解决方案。