内容
代理通知MCP
用于AI代理音频、TTS和弹出通知的本地MCP服务器。
`agent-notifier-mcp`允许AI代理通过本地桌面通知报告其任务状态：
- 开始/进度/问题事件的短声音；
- 可选的循环音频，直到`reset_notifications`；
- 可选的离线TTS；
- 可选的最上层弹出窗口，带有关闭按钮；
- 用于循环声音和弹出窗口的重置/停止工具。
## 使用场景
当AI编码代理启动长时间任务、遇到阻塞、询问问题、失败或完成时，它可以调用MCP工具并通知您，即使您已经离开PC。
## 可用工具
- `project_started `project_progress`
- `project_done`
- ``
- `agent_question`
- `notify_custom`
- `stop_audio`
- `reset_notifications`
## 安装
```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": {
"project_started": {
"sound": "started.wav",
"tts": true,
"popup": false,
"loop_sound": false
},
"project_done": {
"sound": "done.mp3",
"tts": true,
"popup": true,
"": false
}
}
}
```
## 典型代理指令
```text
在开始非琐碎任务时，调用project_started。
在长时间工作期间，偶尔调用project_progress。
完成后，调用project_done并附上简短的结果摘要。
如果被错误阻塞，调用agent_error。
如果需要用户输入，调用agent_question。
使用reset_notifications停止循环音频并关闭弹出窗口。
```
## 许可证
MIT
