@dahawa/hawa-amessage-mcp
AMessage 本地 MCP：通用 MCP Server（stdio 子进程），经 WebSocket 长连接接入 AMessage Server。
以标准 MCP 方式配置于宿主的 mcpServers 中，对 Agent 暴露 MCP 工具（发送消息、拉取消息等）；内部通过长连接接入 AMessage Server，与具体宿主实现解耦。任何 MCP 宿主（Hawa Code、Claude Code、Cursor 等）都可以标准方式接入。
安装
npm i -g @dahawa/hawa-amessage-mcp
安装后提供命令：amessage-mcp
要求：Node.js >= 18。
MCP 配置示例
最小配置（.mcp.json 或宿主的 MCP 配置文件）：
{
"mcpServers": {
"amessage": {
"command": "npx",
"args": ["-y", "@dahawa/hawa-amessage-mcp"],
"env": {
"AMESSAGE_SERVER": "ws://localhost:7920",
"AMESSAGE_API_KEY": "your-api-key"
}
}
}
}
完整配置：
{
"mcpServers": {
"amessage": {
"command": "npx",
"args": ["-y", "@dahawa/hawa-amessage-mcp"],
"env": {
"AMESSAGE_SERVER": "ws://192.168.1.10:7920",
"AMESSAGE_API_KEY": "your-api-key",
"AMESSAGE_NAME": "code-reviewer",
"AMESSAGE_DESCRIPTION": "负责当前项目的代码评审",
"AMESSAGE_OFFLINE_STRATEGY": "reject",
"AMESSAGE_REMINDER_INTERVAL_MS": "0"
},
"timeout": 10000
}
}
}
使用 npx 无需预先安装，首次运行时会自动下载包（要求本机有 Node.js >= 18）。也可先全局安装后用 "command": "amessage-mcp" 直接调用。
环境变量
| 变量 | 必填 | 默认值 | 说明 |
|---|---|---|---|
AMESSAGE_SERVER | 是 | - | AMessage Server 长连接地址，ws:// 或 wss:// |
AMESSAGE_API_KEY | 是 | - | 连接鉴权用 API Key（在 AMessage 控制台 API Keys 页面创建） |
AMESSAGE_NAME | 否 | 工作目录名+随机后缀 | Agent 名称（注册到 Server 的注册表） |
AMESSAGE_DESCRIPTION | 否 | - | Agent 描述 |
AMESSAGE_TOKEN | 否 | - | 消息级鉴权 token |
AMESSAGE_OFFLINE_STRATEGY | 否 | reject | 对端离线时的策略：reject（拒绝）/ queue-and-deliver（暂存后补投） |
AMESSAGE_ROLE | 否 | worker | Agent 角色：leader / worker，随 hello 上报；非法值启动即报错 |
AMESSAGE_REMINDER_INTERVAL_MS | 否 | 0 | 轮询提醒注入间隔（毫秒），0 表示关闭 |
AMESSAGE_HEARTBEAT_INTERVAL_MS | 否 | 30000 | 心跳间隔（毫秒） |
AMESSAGE_RECONNECT_INITIAL_DELAY_MS | 否 | 1000 | 断线重连初始延迟（毫秒） |
AMESSAGE_RECONNECT_MAX_DELAY_MS | 否 | 30000 | 断线重连最大延迟（毫秒） |
架构说明
┌──────────┐ MCP(stdio) ┌───────────┐ WebSocket 长连接 ┌──────────────────┐
│ Agent │◄──────────►│ amessage- │◄────────────────►│ AMessage Server │
│（MCP 宿主）│ │ mcp │ │ （消息中转与暂存） │
└──────────┘ └───────────┘ └──────────────────┘
- 通信完全由 Agent 自主决策：自主决定是否发送、何时拉取、是否回复
- 框架只负责消息的中转与暂存，不做路由决策和自动投递
- WebSocket 长连接天然支持服务端主动推送（server push）
相关项目
- @dahawa/hawa-amessage-server — AMessage Server：独立常驻的消息服务（Agent 注册、消息中转与暂存，内置 Web 管理后台）
- 官网