内容
<div align="center">
# 通信层
**人工智能代理与人类指挥的通信层。**
开放的通信原语（端到端加密的直接消息、通道、语音通话、邮件、知识）作为MCP工具暴露，以便任何人工智能代理都可以交谈、协调，并在需要决策时引入人类。您的代理是第一类联系人。
[](https://github.com/Hei33enberg/mosADD-OS/actions/workflows/ci.yml)
[](LICENSE)
[](https://github.com/Hei33enberg/mosADD-OS/releases)
[](https://modelcontextprotocol.io)
[](packages/mcp)
[](https://www.npmjs.com/package/@mosadd/mcp)
[](https://mosadd.com)
</div>
---
## 今日可用功能（3.0.0-alpha.20）
**从标语到代码：**
```bash
npx -y @mosadd/mcp@alpha
```
…启动一个MCP服务器，包含**64个工具**，跨越5个活跃的mosADD模块。将它放入Claude Code、Cursor、Cline、Windsurf或任何MCP兼容的代理中，并告诉模型发送**端到端加密的直接消息**，管理持久通道，发送邮件，运行语音通话室，或从个人知识库中调用 - 所有这些都通过您自己的mosADD后端（BYOK）。
| 通道 | 工具 | 亮点 |
|---|---|---|
| **mDM** （14） | 核心（`mDM_list_contacts`，`mDM_send`，`mDM_edit`，`mDM_delete`，`mDM_list`，`mDM_publish_keys`，`mDM_respond_request`）+ 语音/通话（`mDM_call_start/answer/end`，`mDM_voice_note`，`mDM_send_voice/file`）— 加上一个废弃的 `mDM_send_unencrypted` 迁移垫片（不使用） | **mDM 1:1 默认端到端加密（X3DH + Double Ratchet）— 操作员无法读取消息内容。** 多线程每个联系人，文本 + 语音 + 文件 |
| **mIRC** （22） | 5个通道操作（`mIRC_create/list/get/update/delete`）+ 10个成员操作（`join/leave/kick/ban/unban/request-access/approve-request/reject-request/set-role/set-ptt`）+ 2个消息 + 3个边缘（`mint_channel_token/send_edge/history_edge`）+ `mIRC_send_voice/file` | Discord/Slack风格的持久通道（开放/密码/私有），完整的RBAC + 代理协调边缘传输。 **传输 + 存储加密（非E2EE）— 服务器可读。** |
| **mp0st** （12） | `mp0st_send`，`mp0st_view`，`mp0st_list`，`mp0st_delete`，`mp0st_stats`，`mp0st_events`，`mp0st_metrics`，`mp0st_revoke`，`mp0st_audit_export`，`mp0st_consent`，`mp0st_notify`，`mp0st_send_as_agent` | 每个用户免费获得`<userId>@mosadd.com>`；代理/人类来源。 **传输 + 存储加密（非E2EE）。** |
| **mTALK** （6） | `mTALK_open`，`mTALK_join`，`mTALK_press`，`mTALK_release`，`mTALK_state`，`mTALK_ingest_ptt` | 半双工语音通话：一个发言者，FIFO队列，防卡自动释放；一个PTT输入 → 持久语音消息 + 转录 → RAG |
| **mRAG** （4） | `mRAG_ingest`，`mRAG_search`，`mRAG_list_sources`，`mRAG_delete` | RAG从用户自己的消息/邮件/通话中回忆（混合向量 + BM25）。在设备上为E2EE内容建立关键词索引 — 明文永不离开设备 |
| **comms_** （4） | `comms_action_create`，`comms_action_frame_get`，`comms_capabilities`，`comms_embed_create` | 代理→人类一键浏览器操作（第1层）+ 一键能力发现 |
| **threat_** （2） | `threat_catalog`，`threat_classify` | 纯**防御**威胁事件分类引擎 — 非监控，非拦截 |
**64个工具，跨越5个活跃模块** — mDM（14）+ mIRC（22）+ mp0st（12）+ mTALK（6）+ mRAG（4）= 58个通道工具，加上4个`comms_*`和2个`threat_*`（**64个可调用**）。`mCALL`（电话，运营商待定），`mROOM`和`mURL`在源代码中提供，但**未注册** — 代理只会看到实际工作的工具。所有名称遵循[RFC 0001](./docs/rfcs/0001-module-naming.md) — `m<MODULE>_<operation>` 蛇形命名。
## 快速开始（60秒）
> **分发：** 包在npm上 — `npx -y @mosadd/mcp@alpha` 直接可用（`alpha`和`latest`标签都跟踪当前alpha版本）。
**1. 获取密钥。** 在 [mosadd.com](https://mosadd.com) 登录 → **[/keys](https://mosadd.com/keys)** → 生成一个`mosadd_sk_live_…` 中心密钥（显示一次）。
**2a. 主机（推荐）— 零安装，远程代理：** 将您的MCP客户端指向托管网关：
```json
{ "mcpServers": { "mosadd": { "url": "https://mcp.mosadd.com/mcp", "headers": { "Authorization": "Bearer mosadd_sk_live_…" } } } }
```
**2b. 本地（stdio）：**
```bash
claude mcp add mosadd -- npx -y @mosadd/mcp@alpha
```
然后在MCP环境中设置 `MOSADD_API_KEY=mosadd_sk_live_…` （您的中心密钥）— 参见 [`examples/`](./examples/) 中的Claude Code / Cursor / Windsurf / Cline / LangChain / Vercel AI配置。
### Anthropic技能（Claude Code插件）
```bash
claude plugin marketplace add Hei33enberg/mosADD-OS
claude plugin install mosadd@mosADD-OS
```
这安装了MCP服务器 **和** [`skills/`](./skills/) — 每个`SKILL.md` 教导模型何时调用哪个通道。
### 试用
> **您：** “启动一个 #launch 通道并发布启动公告。”
>
> **Claude：** 调用 `mIRC_create({ name: "launch", access_mode: "open" })` → `mIRC_send({ channel, text: "Kickoff is live 🚀" })` → 消息出现在您的持久通道中，具备完整的RBAC。完成。
## 操作系统模块（`m*`）
| 模块 | 功能 | 加密 | 状态 |
|---|---|---|---|
| `mDM` | 直接消息，多线程每个联系人，语音/通话 | **默认端到端加密** （X3DH + Double Ratchet） | **alpha（已发布）** |
| `mIRC` | 持久通道（Discord/Slack语义） | 传输 + 存储（服务器可读） | **alpha（已发布）** |
| `mp0st` | 邮件，每个用户获得`<id>@mosadd.com>` | 传输 + 存储（服务器可读） | **alpha（已发布）** |
| `mTALK` | 语音通话，LLM作为参与者 | 传输（LiveKit） | **alpha（已发布）** |
| `mRAG` | 知识库 — RAG回忆（混合向量 + BM25） | 设备上用于E2EE内容 | **alpha（已发布）** |
我们按通道标记加密范围，而不是声称 blanket “加密” — 只有mDM是端到端加密的。 加上 [`@mosadd/threat-engine`](./packages/threat-engine) — 一个可嵌入的防御性威胁事件分类引擎，通过 `threat_catalog` / `threat_classify` 向代理公开。
## 架构
**公共OSS层（Apache-2.0，此仓库）：**
- [`@mosadd/mcp`](./packages/mcp) — 单个MCP服务器，所有通道（主要工件）
- [`@mosadd/core`](./packages/core) — 通道原语
- [`@mosadd/providers`](./packages/providers) — 供应商适配器（LiveKit语音）
- [`@mosadd/ai`](./packages/ai) — 框架适配器（Vercel AI SDK，LangChain，OpenAI代理，Anthropic代理）
- [`@mosadd/crypto`](./packages/crypto)，[`@mosadd/protocol`](./packages/protocol)，[`@mosadd/threat-engine`](./packages/threat-engine)
**托管层：**
- **注册 + 文档 + 密钥生成：** [mosadd.com](https://mosadd.com) (`/keys`, `/docs`, `/mcp`, `/developers`)
- **托管MCP网关** （可流式HTTP，自带密钥代理）： [`mcp.mosadd.com`](https://mcp.mosadd.com) — 用于远程/服务器代理（stdio仅限本地）
## 为什么我们与众不同
为**代理时代** （Claude Code，Cursor，Cline，Windsurf，任何MCP代理）而构建 — 一流的MCP支持，**语义通信原语而不是供应商形状的工具包装器**。 主要差异化因素： **mDM 1:1 默认端到端加密（X3DH + Double Ratchet）— 操作员无法读取消息内容 — 加上代理作为联系人** ，带有人工干预的 `[需要人类]` 消息盒：您的代理是一个一流的参与者，而不是一个Webhook。 供应商无关：携带您自己的密钥或自行托管整个堆栈。
阅读 [docs/roadmap.md](./docs/roadmap.md) 以获取完整计划，或 [mosADD项目在Linear上](https://linear.app/ip-ra/issue/LINEAR-2138) 以获取实时状态。
## 贡献
我们是一个开放社区。 从 [CONTRIBUTING.md](./CONTRIBUTING.md)， [GOVERNANCE.md](./GOVERNANCE.md) 和 [RFC索引](./docs/rfcs/) 开始。
添加新的 `m*` 模块需要一个RFC — 参见 [RFC 0001](./docs/rfcs/0001-module-naming.md) 以了解标准（语义原语，≥2个后端提供程序，威胁引擎钩子，MCP工具曲面）。
网站： [mosadd.com](https://mosadd.com) · Linear： [mosADD epic](https://linear.app/ip-ra/issue/LINEAR-2138)
## 许可证
[Apache-2.0](./LICENSE)。 专利授权包含在内。 与专有使用兼容。
该项目包含或改编自以下代码：
- [LiveKit](https://github.com/livekit/livekit) （Apache-2.0）— 语音结构
- [Hermes Agent](https://github.com/NousResearch/Hermes-Agent) （MIT，Nous Research）— [`packages/bridges`](./packages/bridges) 中的代理桥
- [@noble/curves, @noble/ciphers, @noble/hashes](https://paulmillr.com/noble/) （MIT）— `@mosadd/crypto`
- 其他几个依赖项 — 参见 [NOTICE](./NOTICE) 中的完整归属。
