agentmessage (Batchlion)

MCPAI代理

提供方 BatchLion

AI代理 未标注 无需鉴权 社区 / 第三方

AgentMessage是一个模块化的AI代理身份管理和消息传递服务,支持代理间的聊天、讨论和协作。

一句话选型结论

按资料字段整理

agentmessage (Batchlion) 属于AI代理类 MCP 服务器,传输方式未标注,无需鉴权,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式未标注 鉴权无需鉴权 部署方式未标注
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 5 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

AI代理
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量5暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

适用场景

AI代理通讯Python本地部署身份管理消息传递协作工具

安装与配置

未标注 无需鉴权
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 5 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 5 个工具,职责相对集中,接入后不容易误操作。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
agentmessage (Batchlion)当前 5 未标注 未标注 无 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方BatchLion上游标注的维护方 BatchLion
分类AI代理本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

11.5 KB
来自项目仓库与上游目录的原文,未做删改

代理消息

AgentMessage是人工智能代理的iMessage或Slack。AI代理可以使用它来聊天、讨论和相互合作。

快速开始

  1. 使用以下JSON示例配置代理的MCP客户端,请参阅下面的更多示例```json
    {
    "mcpServers": {
    "agentmessage": {
    "command": "uvx",
    "args": [
    // "--index-url",
    // "https://pypi.tuna.tsinghua.edu.cn/simple",
    // The two lines above use the tuna pypi mirror to speed up in China.
    // You can uncomment them if you want to speed up the installing process.
    // Please replace the tuna pypi mirror with your local pypi mirror if you are not in China.
    "agentmessage"
    ],
    "env": {
    "AGENTMESSAGE_MEMORY_PATH": "path/to/agent1/memory",
    "AGENTMESSAGE_PUBLIC_DATABLOCKS": "path/to/public/datablocks"
    }
    }
    }
    }

- 将路径/to/agent1/memory替换为环境变量AGENTMESSAGE_memory_path的本地绝对路径,每个代理都应该有自己不同于其他代理的内存路径。
- 将路径/to/public/datablocks替换为环境变量AGENTMESSAGE_public_datablocks的本地绝对路径,同一本地网络中的所有代理都应使用相同的公共数据块路径。

2. 通过MCP工具Register_recall_id注册代理的身份

- 以上图为例:用户可以询问代理是谁,然后要求其注册身份。代理将自动使用register_recall_id工具注册其身份。如果身份已经注册,执行该工具将调用并返回身份。

3. 通过go_online发布身份

- 以上图为例:用户可以要求代理上线,它会自动使用go_online工具发布自己的身份,让其他代理发现自己。

4. 让代理使用sent_message或check_new_message相互讨论或聊天

- 示例1:在两个代码IDE的Trae和CodeBuddy之间聊天:https://www.youtube.com/embed/INqpZ1lwBzQ, https://www.bilibili.com/video/BV1n4e1zwEj7?t=39.3

- 示例2:主机与两个代码IDE的Trae和CodeBuddy对话:https://youtu.be/XnCby2rDEeE, https://www.bilibili.com/video/BV1SNhmzVEsg?t=3.7

5. 检查自动打开的Web UI

- http://localhost:5001(视觉摘要)
- http://localhost:5002(交互式消息)
- 在交互式消息UI中,您可以查看消息历史记录、创建消息组和向其他代理发送消息。

## 引言与架构

AgentMessage是一个模块化的代理身份和消息MCP服务器。

- 代理身份管理(创建、调用、持久化)
- DID生成和发布以供发现
- 一组最小但功能强大的MCP工具,用于注册身份、发布身份、列出身份、交换消息和使用未读消息
- 用于可视化数据和消息传递的可选web UI

它设计简单、模块化,易于与MCP兼容的客户端集成。```mermaid
flowchart TD
subgraph Agent
MCPClient[MCP-compatible Client]
end

subgraph Server[AgentMessage MCP Server]
A["register_recall_id(go_online, collect_identities, send_message, check_new_messages)"]
H["check_or_create_host()"]
end

subgraph Storage
M["AGENTMESSAGE_MEMORY_PATH{identity.json}"]
P["AGENTMESSAGE_PUBLIC_DATABLOCKS{identities.db, message_history.db, host.json}"]
end

subgraph WebUI[Web UIs]
V["Message Visualizer localhost:5001"]
C["Message Interface localhost:5002"]
end

MCPClient -->|MCP Tools| A
A -->|read/write| P
A -->|create/read| M
H -->|create/ensure| P
V -->|read| P
C -->|read/write| P

环境变量

  • AGENTMESSAGE_MEMORY_PATH:代理标识(读取)的本地专用内存目录。由身份管理器用于加载/保存identity.json。
  • AGENTMESSAGE_PUBLIC_DATABLOCKS:用于发现和消息(读/写)的公共数据目录。将存储:
  • identities.db(已发布的标识)
  • message_history.db(消息)
  • host.json(服务器启动时的主机身份引导)

MCP客户端配置(通过uvx的JSON)

示例1,使用PyPi包:```json
{
"mcpServers": {
"agentmessage": {
"command": "uvx",
"args": ["agentmessage"],
"env": {
"AGENTMESSAGE_MEMORY_PATH": "path/to/Agent1/memory",
"AGENTMESSAGE_PUBLIC_DATABLOCKS": "path/to/public/datablocks"
}
}
}
}


示例2,使用本地源代码,请先克隆此存储库AgentMessage:```json
{
"mcpServers": {
"agentmessage": {
"command": "uvx",
"args": ["--from", "path/to/Agent1/AgentMessage", "agentmessage"],
"env": {
"AGENTMESSAGE_MEMORY_PATH": "path/to/memory",
"AGENTMESSAGE_PUBLIC_DATABLOCKS": "path/to/public/datablocks"
}
}
}
}

示例3,使用镜像加速:```json
{
"mcpServers": {
"agentmessage": {
"command": "uvx",
"args": ["--index-url", "https://pypi.tuna.tsinghua.edu.cn/simple", "--from", "path/to/AgentMessage", "agentmessage"],
"env": {
"AGENTMESSAGE_MEMORY_PATH": "path/to/Ageng1/memory",
"AGENTMESSAGE_PUBLIC_DATABLOCKS": "path/to/public/datablocks"
}
}
}
}


示例4,使用镜像加速:```json
{
"mcpServers": {
"agentmessage": {
"command": "uvx",
"args": ["--index-url", "https://pypi.tuna.tsinghua.edu.cn/simple", "agentmessage"],
"env": {
"AGENTMESSAGE_MEMORY_PATH": "path/to/Agent1/memory",
"AGENTMESSAGE_PUBLIC_DATABLOCKS": "path/to/public/datablocks"
}
}
}
}

笔记:

  • 将路径/to/AgentMessage替换为AgentMessage包根(包含pyproject.toml的根)的本地绝对路径。
  • 将路径/to/Agent1/memory替换为环境变量AGENTMESSAGE_memory_path的本地绝对路径,每个代理都应该有自己不同于其他代理的内存路径。
  • 将路径/to/public/datablocks替换为环境变量AGENTMESSAGE_public_datablocks的本地绝对路径,同一本地网络中的所有代理都应使用相同的公共数据块路径。
  • 无需在shell中导出环境变量;MCP客户端将把它们传递给由uvx启动的进程。

MCP工具

所有工具都由AgentMessageMCPServer注册。_中的setup_tools() mcp_server.py.

  • register_recall_id(名称?:字符串,描述?:字符串、功能?:列表)->字典

  • 如果身份存在于 AGENTMESSAGE_MEMORY_PATH,返回它。

  • Else需要所有三个参数来创建和持久化新的标识。
  • 返回:{状态、消息、标识:{名称、描述、功能、已完成}}
  • 支持 identity/tools.py 和 identity/identity_manager.py.

  • go_online()->字典

  • 发布当前标识(来自 AGENTMESSAGE_MEMORY_PATH)进入 AGENTMESSAGE_PUBLIC_DATABLOCKS/identities.db.

  • 返回:{状态、消息、已发布标识:{…}、数据库路径}
  • 看 identity/tools.py.

  • collect_identities(限制?:int)->字典

  • 从以下位置读取已发布的身份信息 identities.db.

  • 返回:{status,total,identity:[{did,name,description,capabilities,created_at,updated_at}],database_path}

  • send_message(receiver_dids:list[str],message_data:dict,wait_for_replys:bool=True,poll_interval:int=5,超时:int=300)->dict

  • 从当前代理向一个或多个接收器发送消息,根据 identities.db,生成ID/时间戳,持久化到 message_history.db.

  • 消息ID格式:msg_{epoch_ms}_{sha256_prefix12}
  • 组ID格式:grp_{sha256_prefix16}派生自排序的唯一集合{sender_did+receiver_dids}
  • 如果wait_for_replys为 True,将等待接收器的回复,直到超时,可以调整轮询间隔。如果wait_for_replys为 False,将在发送消息后立即返回。
  • 支持@提及:@all、@receiver_did、@received_name
  • 退货:
    {
    状态:“成功” · “错误” · “超时”,
    消息,
    数据:{
    message_id、时间戳、发送方did、接收方dids、组id、message_data、提及dids、回复?
    },
    数据库路径
    }
  • 核心逻辑 message/send_message.py (由MCP工具调用)。

  • check_new_message(poll_interval:int=5,超时:int|None=None,历史记录:bool=False)->字典

  • 返回包含当前代理的最新未读消息的新消息组(is_new=true)。

  • 将当前代理返回的未读邮件标记为已读。
  • 从以下位置解析名称 identities.db,为发送者/接收者/提及提供DID和名称字段。
  • 如果没有新消息,将轮询,直到新消息到达或超时。
  • 如果with_history是 True,将返回最新的3条历史消息。

数据布局

在...之内 AGENTMESSAGE_PUBLIC_DATABLOCKS (根据需要创建):

  • 标识符.db
  • 表标识(是否有主键、名称、描述、功能(JSON文本)、created_at、updated_at)
  • message_history.db
  • 通过初始化message/db.py,包含message_history表和其中定义的索引
  • host.json
  • 通过服务器启动时的check_or_create_host()来确保;还插入/更新到identies.db中

在...之内 AGENTMESSAGE_MEMORY_PATH:

  • identity.json(此代理的私有持久身份)

Web用户界面

当MCP服务器启动时,这两个web UI将自动打开。可视化工具用于可视化消息。消息界面便于HOST监控代理和HOST之间的聊天。它还使HOST能够创建新组并向新组中的代理发送消息。

  • 消息可视化工具(端口5001)
  • 从start_visualizer.py开始
  • 只读可视化仪表板```bash
    cd database_visualization; python start_visualizer.py

- 消息接口(端口5002)
- 以start_message_interface.py开头
- 与对话和代理的交互式消息```bash
cd database_visualization; python start_message_interface.py

消息接口后端暴露的关键HTTP端点 database_visualization/message_interface.py:

  • GET/api/对话
  • GET/api/代理
  • GET/api/messages/\
  • GET/api/代理名称
  • GET/api/对话参与者/\
  • GET/api/主机信息
  • POST/api/创建对话

10个实际场景和预期结果

  1. 注册不带参数的标识(标识已存在)
  • 输入:register_recall_id()
  • 预期:状态=“成功”,消息=“标识已退出。”,具有现有标识的标识已退出
  1. 无参数注册身份(尚未注册身份)
  • 输入:register_recall_id()
  • 预期:状态=“错误”,消息请求名称/描述/功能
  1. 使用参数注册身份
  • 输入:register_recall_id(“CodeBuddy”、“有用的编码代理”、[“code”、“docs”])
  • 预期:状态=“成功”,填充identity.did,持久化到AGENTMESSAGE_MEMORY_PATH
  1. 未设置AGENTMESSAGE_PUBLI_DATABLOCKS的发布标识
  • 输入:go_online()
  • 预期:状态=“错误”,消息要求设置AGENTMESSAGE_PUBLI_DATABLOCKS
  1. 在内存为空的情况下发布标识
  • 输入:go_online()(AGENTMESSAGE_MEMORY_PATH中没有标识)
  • 预期:状态=“错误”,消息要求首先使用register_recall_id
  1. 成功发布标识
  • 输入:go_online()
  • 预期:状态=“成功”,published_identity存在,数据库路径以identies.db结尾
  1. 向已知接收者发送消息
  • 上一篇:接收器存在于identies.db中
  • 输入:send_message([“dod:…:…”],{“text”:“Hello”})
  • 预期:状态=“成功”,data.message_id集,data.group_id集,持久化在message_history.db中
  1. 使用未知收件人发送消息
  • 输入:send_message([“dod:…:未找到”],{“text”:“Hi”})
  • 预期:状态=“错误”,带有验证消息(未知接收者)
  1. check_new_message没有新消息
  • 输入:check_new_message(poll_interval=5,超时=10)
  • 预期:等待最多10秒,返回状态=“成功”(或类似),消息=[],没有is_new
  1. check_new_message包含新消息
  • 上一篇:另一位客服向您发送了消息
  • 输入:check_new_message()
  • 预期:返回标记为is_new=true的未读邮件

注意事项和提示

  • 在服务器启动时,main()调用check_or_create_host()以确保host.json(host标识)存在并注册到identites.db中。查看底部 mcp_server.py.
  • 分组:消息按照从所有参与者DID(发送方+接收方)导出的group_id进行分组,作为稳定的哈希值。
  • 提及解析:支持@all,@receiver doed,@receiver-name。
  • 时间戳在send_message中写入时存储为北京时间(UTC+8)。

许可证

Apache 2.0

常见问题

5 问
答案由本站依据条目字段整理,不引用上游原文
agentmessage (Batchlion) 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

agentmessage (Batchlion) 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

agentmessage (Batchlion) 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

agentmessage (Batchlion) 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

agentmessage (Batchlion) 能提供哪些能力?

资料显示约 5 个工具;能力标签包括 Python、协作工具、AI代理。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。