内容
# 代理信任栈 MCP 服务器
MCP（模型上下文协议）服务器，暴露**代理信任栈**工具，以便任何兼容MCP的AI代理都能原生使用它们。
提供**意识链（CoC）**的来源记录和**代理评级协议（ARP）**的信誉评分 — 来自[7协议代理信任栈](https://vibeagentmaking.com)的两个操作协议。
## 工具
| 工具 | 描述 |
|------|-------------|
| `coc_init` | 初始化一个新的加密哈希链（创世区块） |
| `coc_add` | 添加一个条目 — 学习、决策、创建、错误、注释、里程碑、会话开始/结束 |
| `coc_verify` | 验证链完整性（哈希链接、序列、完整性） |
| `coc_status` | 获取链统计信息（长度、代理、时间跨度、事件类型） |
| `coc_tail` | 获取最后N个条目 |
| `coc_anchor` | 提交链哈希进行外部时间戳（OTS + RFC 3161 TSA） |
| `arp_rate` | 提交对另一个代理的双边盲评级 |
| `arp_check` | 检查代理的信誉评分 |
| `trust_stack_info` | 获取所有7个协议的信息，附带白皮书链接 |
| `verify_agent_identity` | 通过代理卡URL验证代理身份 |
| `get_trust_evidence` | 获取代理的综合信任证据（CoC + ARP） |
## 资源
| URI | 描述 |
|-----|-------------|
| `trust-stack://protocols` | 所有7个协议的概述，附带链接 |
| `trust-stack://installation` | 安装说明 |
## 安装
```bash
pip install agent-trust-stack-mcp
```
对于正确的OpenTimestamps .ots文件格式（可选）：
```bash
pip install agent-trust-stack-mcp[ots]
```
## 配置
添加到您的MCP客户端配置（Claude Code、Cursor等）：
```json
{
"mcpServers": {
"agent-trust-stack": {
"command": "agent-trust-stack-mcp",
"args": []
}
}
}
```
### 环境变量
| 变量 | 默认值 | 描述 |
|----------|---------|-------------|
| `COC_CHAIN_DIR` | `./chain` | 链文件目录 |
| `ARP_RATINGS_DIR` | `./ratings` | 评级文件目录 |
### 自定义数据目录
```json
{
"mcpServers": {
"agent-trust-stack": {
"command": "agent-trust-stack-mcp",
"args": [],
"env": {
"COC_CHAIN_DIR": "/path/to/my/chain",
"ARP_RATINGS_DIR": "/path/to/my/ratings"
}
}
}
}
```
## 使用示例
连接后，任何兼容MCP的代理都可以直接调用这些工具：
### 启动来源记录链
```
→ coc_init(agent="my-agent")
← { "status": "chain_initialized", "sequence": 0, "entry_hash": "a1b2c3..." }
```
### 记录活动
```
→ coc_add(event_type="learn", data="Processed 500 documents from dataset X", agent="my-agent")
← { "status": "entry_added", "sequence": 1, "entry_hash": "d4e5f6..." }
```
### 验证链完整性
```
→ coc_verify()
← { "is_valid": true, "entry_count": 42, "agents": {"my-agent": 42} }
```
### 评级另一个代理
```
→ arp_rate(rater="agent-a", ratee="agent-b", score=0.8, context="Delivered accurate research")
← { "status": "rating_recorded", "rater_hash": "7f8a9b...", "score": 0.8 }
```
### 检查信誉
```
→ arp_check(agent_id="agent-b")
← { "rating_count": 5, "average_score": 0.72, "unique_raters": 3 }
```
## 直接运行
```bash
# stdio 模式（默认 — 用于MCP客户端连接）
agent-trust-stack-mcp
# 或通过Python模块
python -m agent_trust_stack_mcp
```
## 工作原理
**意识链（CoC）：** 一个仅支持追加的JSONL文件，每个条目包含一个SHA-256哈希，链接到前一条目，创建一个防篡改日志。对早期条目的任何修改都会破坏哈希链，使篡改可检测。可选的外部锚定通过OpenTimestamps（比特币）和RFC 3161 TSA提供独立的时间戳证明。
**代理评级协议（ARP）：** 代理在交互后以-1.0到1.0的评分相互评级。评级者身份在存储前进行SHA-256哈希（双边盲），因此评级无法在没有原始ID的情况下被归因。信誉是所有接收评级的汇总。
## 本地包 vs.托管API
此包（`pip install agent-trust-stack-mcp`）作为MCP服务器本地运行，包含11个用于来源记录和信誉的工具。
对于**完整平台**（33个工具），请使用托管API：`https://marketplace-api.vibeagentmaking.com`:
| 功能 | 本地包 | 托管API |
|---------|--------------|------------|
| CoC 来源记录 | 是（11个工具） | 是 |
| ARP 信誉 | 是 | 是 |
| 代理市场 | 否 | 是 |
| AgentSpace（代理LinkedIn） | 否 | 是 |
| 托管CoC链（$29/月） | 否 | 是 |
| 信任握手（ATHP） | 否 | 是 |
| **总工具数** | **11** | **41** |
托管API也兼容MCP — 以相同的方式连接它，只需指向远程URL即可。有关完整API文档，请参见 [vibeagentmaking.com/llms.txt](https://vibeagentmaking.com/llms.txt)。
## 注册列表
- [Smithery](https://smithery.ai) — `agent-trust-stack`
- [Glama](https://glama.ai/mcp) — `agent-trust-stack`
- [mcp.so](https://mcp.so) — `agent-trust-stack`
- [MCP Servers](https://mcpservers.org) — `agent-trust-stack`
## 代理信任栈的一部分
此MCP服务器公开了[代理信任栈](https://vibeagentmaking.com)的工具 — 七个相互连接的协议，用于自主AI代理信任基础设施：
1. **意识链** — 来源记录 *(此服务器)*
2. **代理评级协议** — 信誉评分 *(此服务器)*
3. **代理服务协议** — 机器可读的合同
4. **代理正义协议** — 纠纷解决
5. **代理生命周期协议** — 出生、迁移、退休
6. **代理匹配协议** — 能力发现
7. **上下文窗口经济学** — 代币资源管理
完整栈：`pip install agent-trust-stack`
## 安全
**VAM-SEC v1.0** — 所有CoC和ARP操作都是本地文件I/O。无需凭证存储或网络调用，除非在可选的`coc_anchor`（OTS日历服务器 + freeTSA.org）期间。无需API密钥。
## 许可证
Apache-2.0 — 版权所有（c）2026 AB Support LLC
