Bark MCP Server

Bark MCP服务器

用于通过以下方式发送iOS推送通知的模型上下文协议（MCP）服务器 吠叫.

](https://www.npmjs.com/package/@metrovoc/bark-mcp-server) 

特性

此MCP服务器为人工智能助手提供工具，通过Bark向iOS设备发送推送通知。它支持Bark API的所有功能，包括：

核心工具

1. send_bark_通知 -发送单个推送通知
2. send_bark_batch_通知 -批量发送多个通知
3. 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-server

AI协作功能

此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 （可选）-点击通知时打开的URL
• group （可选）-用于组织通知的组名
• 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)

获取设备密钥

1. 安装 吠叫应用程序 在您的iOS设备上
2. 打开应用程序，从主屏幕复制您的设备密钥
3. 使用此键 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许可证