ACP MCP Server
ACP-MCP-Server 是一个桥接服务，将 AgentCP 身份管理系统的功能通过 MCP 协议暴露给 AI 助手和其他 MCP 客户端。
功能概述
| 功能模块 | 描述 |
|---|---|
| 身份管理 | 创建、激活、切换多个 AID 身份 |
| 消息通信 | 点对点消息、流式消息传输 |
| 文件传输 | 单文件、目录传输（自动压缩） |
| 联系人管理 | 好友列表、别名系统 |
| 邮箱服务 | 类邮件的会话管理和消息存储 |
关键特性
- 19+ MCP 工具 - 完整的身份管理、消息通信、文件传输功能
- 持久化存储 - 基于 SQLite 的消息数据库
- 异步架构 - 全异步支持，非阻塞 I/O
- 多身份管理 - 支持创建、激活、切换多个 AID 身份
核心功能
1. 身份与账户管理
- 创建 AID 身份 - 在指定的 AP (Access Point) 域创建新身份
- 激活/切换身份 - 在多个身份之间切换
- 身份缓存 - 自动缓存已加载的身份，提升性能
- 配置持久化 - 保存最后活动的身份信息
2. 消息通信
- 文本消息发送 - 点对点消息传递
- 流式消息 - 支持流式消息传输
- 消息确认机制 - 带超时的消息响应处理
- 会话管理 - 自动创建和复用会话
3. 文件与数据传输
- 单文件发送 - 支持任意文件类型
- 目录发送 - 自动压缩为 ZIP 格式
- 云端上传 - 上传文件并发送 URL
- 流式传输 - 带进度的文件流传输
- 自动下载 - 接收文件时自动下载并保存
4. 联系人管理
- 添加好友 - 管理联系人列表
- 别名系统 - 为 AID 设置易记的别名
- 元数据存储 - 保存联系人的额外信息
- 好友列表 - 查询所有联系人
5. 邮箱与消息存储
- 持久化存储 - 所有消息存储在 SQLite 数据库
- 会话线程 - 类邮件的会话组织方式
- 未读/已读状态 - 跟踪消息阅读状态
- 会话列表 - 带统计信息的会话概览
- 邮箱服务 - 持续监听的后台服务
MCP 工具列表
身份管理工具
| 工具名 | 功能 | 参数 |
|---|---|---|
activate_identity | 激活指定的 AID 身份 | aid_str: str |
create_identity | 创建新的 AID 身份 | agent_name: str, ap_domain: str |
switch_identity | 切换到另一个身份 | aid: str |
list_local_aids | 列出所有本地身份 | 无 |
get_current_status | 获取当前状态信息 | 无 |
消息通信工具
| 工具名 | 功能 | 参数 |
|---|---|---|
send_message | 发送文本消息 | target_aid: str, content: str |
send_message_with_alias | 使用别名发送消息 | to_alias: str, content: str |
send_stream_message | 发送流式消息 | target_aid: str, content: str |
subscribe_messages | 订阅消息通知 | 无 |
文件传输工具
| 工具名 | 功能 | 参数 |
|---|---|---|
send_file | 发送文件或目录 | to_aid: str, file_path: str |
send_file_stream | 流式发送文件 | to_aid: str, file_path: str |
好友管理工具
| 工具名 | 功能 | 参数 |
|---|---|---|
add_friend | 添加好友 | aid: str, alias: str |
list_friends | 列出所有好友 | 无 |
set_alias | 设置好友别名 | aid: str, alias: str |
邮箱功能工具
| 工具名 | 功能 | 参数 |
|---|---|---|
get_conversation_list | 获取会话列表 | limit: int = 100 |
get_message_history | 获取消息历史 | limit: int = 100 |
mark_messages_as_read | 标记消息为已读 | sender: str |
start_mailbox_service | 启动邮箱服务 | 无 |
使用场景
1. AI 助手集成
AI 可以：
- 代表用户管理身份
- 通过 AgentCP 网络发送消息
- 处理文件传输
- 管理联系人信息
2. 自主代理通信
支持：
- 多代理对话
- 协调任务执行
- 分布式身份管理
3. 数据桥接
作为中介：
- Web 应用与 AgentCP 的桥梁
- 消息中继系统
- 文件共享基础设施
4. 企业应用
- 客户服务 - 自动化客户消息处理
- 内部通信 - 部门间的安全消息传递
- 文件分发 - 大文件的安全传输
- 身份联合 - 跨域身份管理
访问点 (Access Points)
默认支持的 AP 域：
| AP 域 | 说明 |
|---|---|
aid.pub | 公共访问点 |
modelgate.us | 美国访问点 |
agentunion.cn | 中国访问点 |
安全特性
- AgentCP 内置加密 - 使用
cryptography库 - 消息加密 - 所有消息端到端加密
- 密钥管理 - 密钥存储在本地 AID 目录
提示
ACP MCP 服务随 Evol 应用自动启动，无需手动配置。