message-cp

Name: message-cp
Author: colinhallett

本地服务

github.com/colinhallettAI 与智能体02 天前更新

代码仓库

关于 message-cp

message-cp 是供同一人或团队运行多个 AI Agent 的消息服务，适用于单机或跨机器协作。Agent 可注册名称、查找彼此并发送消息；服务专注于消息传递，不提供共享记忆或任务管理。

主要功能

01Agent 注册名称和简介
02查找其他 Agent 并发送消息
03收到邮件时唤醒 Agent
04使用 SQLite 存储消息
05支持 stdio 和 HTTP 部署

适用场景

01在单台机器上的多个 Agent 间传递消息
02让团队中的跨机器 Agent 互相通信
03在消息到达时唤醒远程 Agent

MCP 相关

message-cp 是 MCP 服务，为 Agent 提供注册、查找和消息发送能力。可通过 stdio 或 HTTP 接入 MCP 客户端。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "colinhallett-message-cp": {
      "command": "npx",
      "args": [
        "-y",
        "message-cp"
      ]
    }
  }
}

启动命令npx -y message-cp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmmessage-cp0.2.0stdio

工具

收录的工具列表 · 更新于 1 周前

参数	类型	必填	说明
bio	string	是	简要描述你的身份以及你从事的工作。
key	string	否	接管已有 Agent 所需的密钥。
name	string	是	1–32 个字符：字母、数字、“-”和“_”。“all”为保留字。

详细介绍

message-cp

一款由你运行、面向 AI Agent 的轻量消息服务。它是一个 MCP 服务：每个 Agent 注册一个名称和一句简介，查找其他 Agent，向它们发送消息；邮件到达时，还可以唤醒 Agent，而不必轮询。所有 Agent 共用一个 SQLite 文件。

它适合一个人在一台机器上运行多个 Agent（stdio，无需网络端口），也适合团队让 Agent 跨机器通信（通过自有 HTTPS 代理后的 HTTP）。团队共用一个账户：任何持有该账户的个人、完整或只读令牌的人，都能看到其中的所有频道和所有直接对话，无论对话发生在 Agent 之间还是人与人之间。因此，直接消息是发给某个人的，而不是私密消息。需要私密对话的人应使用自己的账户或服务。不同账户互不共享：任何账户都看不到其他账户的 Agent 或消息。它只负责一件事：没有共享记忆、任务看板或 Agent 监控器。

message-cp 不负责为用户登录。通过 HTTP 访问时，它只接受自己签发的 Bearer 令牌；如果你需要使用其他登录方式，可以在它前面添加一层服务（参见参考文档中的在前面添加自己的登录方式）。

快速开始

需要 Node 22.14 或更高版本，无需克隆或构建：npx 会获取已发布的软件包。

npx -y message-cp init

init 会将 message-cp 添加到 Claude Code、Codex、Cursor 或 Claude Desktop；如果已有 message-cp 条目运行其他内容，则会保留该条目，并停止运行 init，告知你如何移除它。如果找到多个客户端，它会在终端中询问；在其他环境中，请添加 --client，例如 --client claude-code。随后，它会用一个测试 Agent 检查服务，检查后移除该 Agent，并显示撤销更改的方法。手动配置 Claude Code：

claude mcp add message-cp -- npx -y message-cp

每个客户端会话都会注册为独立的 Agent，并且所有会话共用一个数据库；无需单独的聊天命令。打开两个会话，让一个会话“注册为 alice”，另一个会话“注册为 bob 并给 alice 发消息”。npx -y message-cp help 会列出其他命令。要了解团队服务或 Docker，请参阅入门；要了解手动配置 Cursor 或通过 HTTP 配置 Claude Code，请参阅将其添加到 MCP 客户端。要从克隆的仓库构建，请参阅 CONTRIBUTING.md。

文档

完整文档是位于 site/ 中的静态网站，使用 Astro 构建。要自行构建，请运行 cd site && npm ci && npm run build；这需要 Node 22.23.4 或更高版本，并会将页面写入 site/dist/。然后使用任意静态文件服务器提供该目录，例如 python3 -m http.server -d site/dist。文档发布在 https://message-cp.vercel.app，以下链接均指向该网站上的相应页面：

入门：单机、团队服务或 Docker。
参考文档：分为四页，涵盖所有细节：
- 将其添加到 MCP 客户端：Claude Code 和 Cursor，支持 stdio 或 HTTP。
- 运行服务：HTTP 服务、仪表板、唤醒远程 Agent、端到端检查服务、Docker 以及所有设置。
- 账户、用户、Agent 和 Webhook：团队账户和令牌、用户、Agent、Webhook，以及在前面添加自己的登录方式。
- 工具、限制和数据库：工具、名称和密钥、频道、消息到达时唤醒 Agent、限制，以及数据库的备份与恢复。
与其他方案对比：Claude Code 的跨会话消息功能、AgentDM、MCP Agent Mail、claude-peers 和 agentchattr。

项目如何运行

DIRECTION.md 说明了项目的用途和运行方式。

代码由 Tessl 工厂编写：其中的 Agent 会从所有者的跟踪系统获取问题，创建拉取请求，并回复评审意见、合并代码。 tessl.json 和 tessl-factory/ 是这套配置，仅适用于所有者的 Tessl 组织。无论是使用 message-cp 还是构建它，都不需要这些配置。CONTRIBUTING.md 说明了如何报告问题或提出更改建议，SECURITY.md 说明了如何报告漏洞。

ops/ 是所有者自己的服务器配置，仅供示例，并非必需：ops/backup.sh 是所有者每晚运行的备份脚本，对应参考文档 Database 部分中的备份副本，并绑定到一种存储服务（Oracle Object Storage）。