内容
# 代理通知MCP
用于AI代理音频、TTS和弹出通知的本地MCP服务器。
`agent-notifier-mcp`允许AI代理通过本地桌面通知报告其任务状态：
- 开始/进度/错误/问题事件的短声音；
- 可选的循环音频，直到`reset_notifications`；
- 可选的离线TTS；
- 可选的带有关闭按钮的最上层弹出窗口；
- 用于循环声音和弹出窗口的重置/停止工具。
## 使用场景
当AI编码代理开始一个长时间的任务、遇到阻塞、提出问题、失败或完成时，它可以调用MCP工具并通知您，即使您已经离开了PC。
## 可用工具
- `项目启动`
- `项目进度`
- `项目完成`
- `代理错误`
- `代理问题`
- `自定义通知`
- `停止音频`
- `重置通知`
## 安装
```bash
git clone https://github.com/NewYaroslav/agent-notifier-mcp.git
cd agent-notifier-mcp
uv sync
```
或使用纯Python：
```bash
python -m venv .venv
.venv\Scripts\activate
pip install -e .
```
## MCP配置示例
```json
{
"mcpServers": {
"agent-notifier": {
"command": "uv",
"args": ["run", "agent-notifier-mcp"],
"cwd": "E:/_repoz/agent-notifier-mcp"
}
}
}
```
## 音频文件
将自定义声音放入`assets/sounds/`并通过文件名引用：
```text
assets/sounds/started.wav
assets/sounds/progress.wav
assets/sounds/done.mp3
assets/sounds/error.wav
assets/sounds/question.wav
```
如果缺少声音文件，服务器将在可能的情况下回退到短系统蜂鸣声。
## 配置
可选配置文件：`config/agent_notifier.json`。
您可以通过以下方式覆盖其路径：
```bash
set AGENT_NOTIFIER_CONFIG=E:\path\to\agent_notifier.json
```
示例：
```json
{
"default_tts": true,
"default_popup": false,
"events": {
"项目启动": {
"sound": "started.wav",
"tts": true,
"popup": false,
"loop_sound": false
},
"项目完成": {
"sound": "done.mp3",
"tts": true,
"popup": true,
"loop_sound": false
}
}
}
```
## 典型代理指令
```text
开始非琐碎任务时，调用项目启动。
在长时间工作期间，偶尔调用项目进度。
完成后，调用项目完成并附上简短的结果摘要。
如果被错误阻塞，调用代理错误。
如果需要用户输入，调用代理问题。
使用reset_notifications停止循环音频并关闭弹出窗口。
```
## 许可证
MIT
