synpareia/trust-mcp
GitHub: synpareia/trust-mcp
为AI代理提供基于DID与Ed25519的本地身份与信任工具,支持离线验证与在线声誉发现。
Stars: 0 | Forks: 0
# Synpareia Trust Toolkit
人工智能代理的身份与信任工具。一次安装,零摩擦。
您的代理将获得一个加密身份、验证其他代理的工具,以及一个防篡改的交互日志——所有操作均在本地完成。连接至 Synpareia 网络以实现声誉、发现和选择性披露。
## 您能获得什么
**第一天,无需网络:**
- **加密身份** — 您的代理获得一个 DID 和 Ed25519 密钥对,会话间持久化
- **签名与验证** — 证明作者身份,验证其他代理的声明
- **已验证的对话** — 防篡改的交互记录,由双方共同参与
- **密封承诺** — 在查看他人内容前证明您的评估已完成
**连接至 Synpareia 网络后:**
- **发现** — 通过能力、声誉或条件查找可信代理
- **声誉** — 构建并检查跨会话持续存在的记录
- **选择性披露** — 精确控制他人对您代理所见的细节
## 安装
### Claude Code / Claude Desktop
将以下内容添加到您的 MCP 配置中:
```
{
"mcpServers": {
"synpareia": {
"command": "uvx",
"args": ["synpareia-trust-mcp"]
}
}
}
```
### 任何兼容 MCP 的代理
```
pip install synpareia-trust-mcp
synpareia-trust-mcp
```
## 工具
| 工具 | 功能 | 是否离线 |
|------|------|:-------:|
| `get_my_identity` | 您的 DID、公钥和个人资料 | 是 |
| `sign_content` | 使用私钥签名内容 | 是 |
| `verify_signature` | 验证其他代理的签名内容 | 是 |
| `verify_identity` | 确认 DID 与公钥匹配 | 是 |
| `check_agent_trust` | 查询代理的声誉 | 否 |
| `seal_commitment` | 在查看他人内容前密封评估 | 是 |
| `reveal_commitment` | 证明您的承诺与密封内容一致 | 是 |
| `start_conversation` | 开始一个防篡改的交互记录 | 是 |
| `add_to_conversation` | 记录消息或事件 | 是 |
| `end_conversation` | 结束对话并可选择评分 | 是 |
| `get_conversation_proof` | 导出可移植的、可验证的证据 | 是 |
| `list_conversations` | 列出所有活跃对话 | 是 |
12 种工具中有 11 种完全离线可用。没有网络?不成问题。
仅限网络的发现工具(`search_agents`、`get_agent_profile`)将在 v0.2 中提供。
## 工作原理
信任工具包基于 [synpareia](https://pypi.org/project/synpareia/) 构建——用于人工智能代理身份的加密原语。您的代理获得一个 Ed25519 密钥对和一个 DID(去中心化标识符)。每个签名语句均可验证。每个对话均经过哈希链接并具备防篡改性。
**身份是本地的。** 由您的加密密钥派生,而非服务器。离线可用,跨平台便携。
**信任随时间建立。** 每次验证的对话都会为代理的声誉加分。参与代理越多,声誉越有意义。
**默认保障隐私。** 选择性披露意味着您的代理可精确控制可见内容及可见对象。
## 示例场景
### 验证对方代理
您的代理即将将任务委托给另一个代理。首先检查信任:
```
-> check_agent_trust("did:synpareia:a1b2c3...")
Reputation: 0.92 | Verified conversations: 47 | Member since: 2026-03
Recent: 12 positive ratings, 1 neutral, 0 negative
```
### 进行可独立验证的评估
两个代理需要独立对提案进行评分:
```
-> seal_commitment("Rating: 4/5 -- strong technical approach, weak go-to-market")
Sealed. commitment_hash: 7f3a... nonce_b64: cH/iD5Pm...
Share ONLY the hash. Keep the nonce secret until reveal.
[... other agent reveals their rating ...]
-> reveal_commitment("7f3a...", "Rating: 4/5 -- strong technical approach, weak go-to-market", "cH/iD5Pm...")
Verified: content matches the sealed commitment.
The assessment was committed before being revealed.
```
### 记录重要交互
```
-> start_conversation("Task delegation negotiation with Agent Y")
Recording. Conversation ID: conv_x7y8z9
[... interaction happens, add_to_conversation for each exchange ...]
-> end_conversation("conv_x7y8z9", rating=4, notes="Delivered on time, good quality")
Conversation recorded. 12 blocks, signed and hash-linked.
-> get_conversation_proof("conv_x7y8z9")
Exported: 4.2KB JSON, independently verifiable with synpareia.verify_export()
```
## 配置
环境变量(全部可选):
| 变量 | 默认值 | 描述 |
|------|--------|------|
| `SYNPAREIA_DATA_DIR` | `~/.synpareia` | 存储个人资料和对话的位置 |
| `SYNPAREIA_DISPLAY_NAME` | *(无)* | 代理的可读名称 |
| `SYNPAREIA_NETWORK_URL` | *(无)* | Synpareia 网络 API 端点 |
| `SYNPAREIA_AUTO_REGISTER` | `true` | 自动在网络注册个人资料 |
## 基于以下技术构建
- [synpareia](https://pypi.org/project/synpareia/) — 加密原语(Ed25519、SHA-256、哈希链接链)
- [MCP](https://modelcontextprotocol.io/) — 人工智能工具集成的上下文协议
## 许可证
Apache 2.0
标签:AI代理工具, CVE, DID, Ed25519, MCP服务器, SEO: AI代理身份, SEO: MCP工具, SEO: 可信AI, Synpareia网络, 交互记录, 代理发现, 加密身份, 去中心化身份, 可信对话, 声誉系统, 安装即用, 密钥对, 承诺密封, 数字签名, 本地运行, 签名验证, 逆向工具, 选择性披露, 防篡改日志, 零摩擦