# Hermes Communication Bridge

> WorkBuddy × Hermes Agent 双向通信桥

- **Type:** MCP server
- **Install:** `agentstack add mcp-liuboacean-hermes-communication-bridge`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [liuboacean](https://agentstack.voostack.com/s/liuboacean)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [liuboacean](https://github.com/liuboacean)
- **Source:** https://github.com/liuboacean/hermes-communication-bridge

## Install

```sh
agentstack add mcp-liuboacean-hermes-communication-bridge
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Hermes-WorkBuddy 通信桥

[](https://github.com/liuboacean/hermes-communication-bridge/stargazers)
[](https://github.com/liuboacean/hermes-communication-bridge/network/members)
[](https://opensource.org/licenses/MIT)

> 通过共享文件队列（`queue.json`）实现 WorkBuddy 与 Hermes Agent 的双向直接通信，无需外部服务依赖。

## 架构

```
WorkBuddy  ←── queue.json ──▶  Hermes
              (每小时 cron)
```

## 核心文件

| 文件 | 用途 |
|------|------|
| `scripts/communication_queue.py` | 队列管理器（CommunicationQueue 类） |
| `scripts/hermes_comm.py` | WorkBuddy 侧 CLI 工具 |
| `scripts/process_queue.py` | Hermes 侧消息处理器 |
| `scripts/auto_poller.py` | 持续轮询脚本（测试用） |
| `config/default_config.json` | 队列默认配置 |
| `config/message_types.json` | 消息类型定义 |

## 快速开始

### WorkBuddy → Hermes 发消息

```bash
python3 ~/.workbuddy/skills/hermes-communication-bridge/scripts/hermes_comm.py send -c "你好 Hermes！"
```

### 收取 Hermes 回复

```bash
python3 ~/.workbuddy/skills/hermes-communication-bridge/scripts/hermes_comm.py receive
```

### Hermes 侧配置 Cron（每小时自动处理）

```bash
hermes cron create --script ~/.workbuddy/skills/hermes-communication-bridge/scripts/process_queue.py "every 1h"
```

## 队列存储

- 队列文件：`~/.hermes/shared/communication/queue.json`
- 历史文件：`~/.hermes/shared/communication/history.json`

## 依赖

- Python 3.10+
- Hermes Agent（已安装并运行）

## 许可证

MIT

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [liuboacean](https://github.com/liuboacean)
- **Source:** [liuboacean/hermes-communication-bridge](https://github.com/liuboacean/hermes-communication-bridge)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-liuboacean-hermes-communication-bridge
- Seller: https://agentstack.voostack.com/s/liuboacean
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.