Bark MCP服务器
用于通过以下方式发送iOS推送通知的模型上下文协议（MCP）服务器 吠叫.
特性
此MCP服务器为人工智能助手提供工具，通过Bark向iOS设备发送推送通知。它支持Bark API的所有功能，包括：
核心工具
- send_bark_通知 -发送单个推送通知
- send_bark_batch_通知 -批量发送多个通知
- check_bark_server_health -检查Bark服务器是否正常
支持的树皮功能
- 基本通知 有标题、副标题和正文
- URL重定向 -点击通知时打开链接
- 通知分组 -按组组织通知
- 定制图标 -使用自定义通知图标（iOS 15+）
- 声音定制 -使用自定义通知声音
- 呼叫通知 -重复播放声音30秒
- 通知级别:
- active （默认） - timeSensitive -在聚焦模式下显示 - passive -无声通知 - critical -覆盖静音/请勿打扰模式
- 徽章管理 -设置应用图标徽章编号
- 加密支持 -发送加密通知
安装
快速入门（推荐）
npx @metrovoc/bark-mcp-server全球安装
npm install -g @metrovoc/bark-mcp-server
bark-mcp-server本地安装
npm install @metrovoc/bark-mcp-server
npx @metrovoc/bark-mcp-server环境变量
为了便于使用，请设置以下环境变量：
BARK_KEY：您的Bark设备密钥（自动使用时需要）BARK_SERVER_URL：Bark服务器URL（可选，默认为https://api.day.app)
用法
使用克劳德代码
推荐（带环境变量）：
claude mcp add bark -e BARK_KEY=your-device-key -- npx -y @metrovoc/bark-mcp-server手动配置：
{
"bark": {
"command": "npx",
"args": ["-y", "@metrovoc/bark-mcp-server"],
"env": {
"BARK_KEY": "your-device-key",
"BARK_SERVER_URL": "https://api.day.app"
}
}
}有关详细的Claude Code设置说明，请参阅 CLAUDE.md.
使用克劳德桌面
将服务器添加到您的 claude_desktop_config.json:
{
"mcpServers": {
"bark": {
"command": "npx",
"args": ["-y", "@metrovoc/bark-mcp-server"],
"env": {
"BARK_KEY": "your-device-key",
"BARK_SERVER_URL": "https://api.day.app"
}
}
}
}替代配置方法
全球安装：
claude mcp add bark -e BARK_KEY=your-device-key -- bark-mcp-server直接Node.js：
claude mcp add bark -e BARK_KEY=your-device-key -- node /path/to/@metrovoc/bark-mcp-server/build/index.js与MCP检查员一起
用于测试和调试：
npx @modelcontextprotocol/inspector npx @metrovoc/bark-mcp-server对于环境变量：
BARK_KEY=your-device-key npx @modelcontextprotocol/inspector npx @metrovoc/bark-mcp-serverAI协作功能
此MCP服务器专门设计用于实现高效 人工智能协作像Claude Code这样的AI助手可以使用这些工具：
- 🚨 当错误需要干预时提醒您
- ✅ 任务完成并准备审查时通知
- 🤔 需要用户输入时请求决策
- 🧪 召唤您进行测试和验证
- 📊 提供长时间运行操作的进度更新
智能工具描述指导AI选择适当的通知优先级和时间，使您能够在AI处理日常任务的同时专注于其他工作。
工具参考
send_bark_通知
向iOS设备发送单个推送通知。 AI助手应使用此功能在任务完成、出现错误或需要输入时通知用户。
参数：
body（必填）-通知内容/消息server_url（可选）-Bark服务器URL（默认为Bark_server_URL环境变量或https://api.day.app)device_key（可选）-设备密钥（默认为BARK_key env var）title（可选）-通知标题subtitle（可选）-通知副标题url（可选）-点击通知时打开的URLgroup（可选）-用于组织通知的组名icon（可选）-自定义图标URL（iOS 15+）sound（可选）-自定义通知声音名称call（可选）-重复播放声音30秒（用于关键问题）level（可选）- 优先级:
- critical：需要立即关注的紧急问题（错误、故障） - timeSensitive：焦点模式期间的重要更新（任务完成、需要测试） - active：一般通知（进度更新） - passive：低优先级背景信息
badge（可选）-应用程序图标上的徽章编号ciphertext（可选）-加密消息内容
AI使用示例：
// Critical error requiring immediate attention
{
"body": "❌ Build failed with 5 errors. Your immediate attention required.",
"title": "Critical: Build Failure",
"level": "critical",
"call": true
}
// Task completion notification
{
"body": "✅ User authentication system completed. Ready for testing.",
"title": "Task Complete",
"level": "timeSensitive"
}
// Progress update
{
"body": "📊 Database migration completed successfully (3/5 steps done).",
"title": "Progress Update",
"level": "active"
}send_bark_batch_通知
在单个批处理操作中发送多个通知。 用于通知多个团队成员或发送不同优先级的更新。
参数：
notifications（必填）-通知对象数组（格式与单个通知相同）server_url（可选）-Bark服务器URL（默认为Bark_server_URL环境变量或https://api.day.app)
check_bark_server_health
检查Bark服务器是否运行正常。 人工智能应主动调用此功能，以确保可靠的用户通信。
参数：
server_url（可选）-要检查Bark服务器URL（默认为Bark_server_URL env var或https://api.day.app)
获取设备密钥
- 安装 吠叫应用程序 在您的iOS设备上
- 打开应用程序，从主屏幕复制您的设备密钥
- 使用此键
device_key参数
Bark服务器设置
您可以使用：
- 官方Bark服务：
https://api.day.app - 自托管Bark服务器（参见 树皮服务器)
发展
# Watch mode for development
npm run dev
# Build
npm run build
# Start the server
npm start许可证
MIT许可证