Barkme Mcp Server

Barkme MCP 服务

一个通过 Bark 服务提供 iOS 推送通知的模型上下文协议（MCP）服务。通过简洁、智能的界面，直接从 Claude 对话中发送通知。

功能

• 单一工具接口：一个 notify 工具即可处理所有通知场景
• 设备别名：使用友好且可配置的别名（如“iPhone:key1”、“macOS:key2”），无需向 AI 暴露设备密钥
• 异步优先：通过后台投递和结构化日志记录，实现非阻塞通知
• 完整支持 Bark API：支持全部 20 多个参数，包括加密消息和通知管理
• 更新/删除通知：使用通知 ID 修改或删除已发送的通知

快速开始

前提条件

• Node.js 20+
• iOS 应用中的 Bark 设备密钥（设置教程）
• MCP 客户端，例如 Claude Desktop 或 Claude Code

通过 npmjs

集成 Claude Desktop

将以下内容添加到 Claude Desktop 配置文件中：

• macOS/Linux：~/.config/claude-desktop/claude_desktop_config.json
• Windows：%AppData%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "barkme": {
      "command": "npx",
      "args": ["@vibeworks/barkme-mcp-server"],
      "env": {
        "LOG_LEVEL": "info",
        "BARK_DEVICES": "iPhone:<your key>",
        "BARK_SERVER": "https://api.day.app",
        "BARK_GROUP": "Claude",
        "BARK_RETRY": "2",
        "BARK_ASYNC": "true"
      }
    }
  }
}

添加配置后重启 Claude Desktop。Barkme 服务将显示在 MCP 工具部分。

通过 Smithery

通过 Smithery 为 Claude Desktop 自动安装 barkme-mcp-server：

npx -y @smithery/cli install @vibeworks/barkme-mcp-server --client claude

从源代码安装

git clone https://github.com/thevibeworks/barkme-mcp-server
cd barkme-mcp-server
npm install
npm run build

{
  "mcpServers": {
    "barkme": {
      "command": "node",
      "args": ["/absolute/path/to/barkme-mcp-server/dist/index.js"],
      "env": {
      ...
      }
    }
  }
}

使用示例

询问 Claude：

• “给我发一条内容为‘Hello World’的通知”
• “给我的 iPhone 和 iPad 发送一条内容为‘Meeting in 10 minutes’的通知”
• “发送一条关于服务器维护的严重警报”
• “将 ID 为 ‘deploy-123’ 的通知更新为 ‘Deployment completed’”

工具参考

notify

通过 Bark 服务向 iOS 设备发送推送通知。

关键参数：

参数	类型	描述
message	字符串	通知正文
title	字符串	显示在正文上方的粗体标题
level	枚举	紧急程度：passive、active、timeSensitive、critical
targets	数组	设备别名（例如 ["iPhone", "iPad"]）
icon	URL	自定义图标图片
url	URL	点击后打开的链接
id	字符串	用于更新/删除通知
delete	布尔值	删除通知（需要提供 id）

响应格式：

Sending notification - queued for background delivery
To: `iPhone`, `iPad`
Level: timeSensitive

Delivery status will be logged to console:
2025-07-29T15:26:17.123Z [INFO] Notification delivered to iPhone in 0.234s
2025-07-29T15:26:17.145Z [INFO] Notification delivered to iPad in 0.267s

环境变量

变量	默认值	描述
BARK_DEVICES	-	必填：设备密钥：key1,key2，或别名：iPhone:key1,iPad:key2
BARK_DEFAULT_DEVICE	第一个设备	用于回退的默认设备别名
BARK_SERVER	https://api.day.app	Bark 服务 URL
BARK_GROUP	Bark MCP Server	默认通知组
BARK_SOUND	-	默认通知声音
BARK_ICON	-	默认图标 URL
BARK_LEVEL	-	默认紧急程度
BARK_VOLUME	-	默认音量（0-10）
BARK_RETRY	1	失败时的重试次数（0-10）
BARK_ASYNC	true	异步模式：true（发送后不等待）或 false（阻塞）
LOG_LEVEL	info	日志级别：debug、info、warn、error

开发

项目结构

barkme-mcp-server/
├── src/
│   ├── index.ts          # Main MCP server implementation
│   └── logger.ts         # Simple structured logging
├── dist/
│   ├── index.js          # Compiled executable
│   ├── logger.js         # Compiled logger
│   └── *.d.ts           # Type definitions
├── references/           # Reference materials
├── package.json          # Project configuration
├── tsconfig.json         # TypeScript configuration
├── CLAUDE.md            # Development guide
└── README.md            # This file

构建命令

npm run build        # Compile TypeScript
npm run watch        # Watch mode for development
npm start           # Run the compiled server

许可证

MIT

相关项目

• Bark - 原始 iOS 通知服务
• barkme-tools - 原始 Shell 脚本实现
• Model Context Protocol - MCP 规范