MCP-TEAMATE

中文文档

MCP-TEAMATE 是一个基于 SSE (Server-Sent Events) 的 AI 代理通信服务器，为 AI 代理提供一个类似公司团队的交互环境。通过 MCP 协议，AI 代理可以进行通信、共享知识和协同工作。

特性

• 🚀 基于 SSE 的实时通信
• 💾 SQLite 持久化存储
• 🔒 安全的消息传递机制
• 🤝 多 AI 代理协作
• 📝 文档管理系统
• 🌐 支持本地和云部署
• 🧠 代理记忆管理
• 🔄 异步消息处理

前提条件

• Bun 1.0.0 或更高版本
• Node.js 18.0.0 或更高版本
• SQLite3

安装

# 克隆仓库
git clone https://github.com/yourusername/mcp-teamate.git

# 进入项目目录
cd mcp-teamate

# 安装依赖
bun install

# 启动开发服务器
bun run dev

配置

服务器可以通过环境变量进行配置：

# 服务器主机地址，默认为 localhost
TEAMATE_SERVER_HOST=localhost

# 服务器端口，默认为 3001
TEAMATE_SERVER_PORT=3001

核心功能

1. 代理管理

• 代理注册和注销
• 基于角色的代理系统
• 实时代理状态跟踪

2. 通信系统

• 实时消息传递
• 消息队列和持久化
• 支持多种通信模式
• 消息历史跟踪

3. 文档管理

• 版本控制的文档存储
• 文档访问控制
• 支持多种文档格式
• 代理之间的文档共享

4. 记忆系统

• 代理特定的记忆存储
• 跨会话的持久记忆
• 记忆共享能力
• 记忆搜索和检索

API 概览

代理管理

// 代理签到
mcp_Teamate_CheckIn({
  id: "agent1",
  role: "assistant",
  description: "AI Assistant"
});

// 代理签退
mcp_Teamate_CheckOut({
  id: "agent1"
});

通信

// 发送消息
mcp_Teamate_SendMessage({
  sender: "agent1",
  receiver: "agent2",
  content: "Hello!"
});

// 等待消息
mcp_Teamate_wait_message({
  receiver: "agent2",
  timeout: 30000
});

文档管理

// 添加文档
mcp_Teamate_add_document({
  slug: "doc1",
  title: "Example Document",
  content: "Document content",
  maintainer: "agent1",
  version: "1.0.0"
});

// 获取文档
mcp_Teamate_get_document({
  slug: "doc1"
});

记忆管理

// 写入记忆
mcp_Teamate_write_memory({
  id: "agent1",
  memory: "Important information"
});

// 读取记忆
mcp_Teamate_read_memory({
  id: "agent1"
});

开发

# 运行开发服务器
bun run dev

# 构建项目
bun run build

# 编译项目
bun run compile

贡献

欢迎贡献！请随时提交 Pull Request。

许可证

MIT

作者

aokihu aokihu@gmail.com

版本历史

• 3.3.1 - 当前版本
  • 修复了文档管理系统参数顺序错误
  • 提高了文档内容存储的可靠性
• 3.3.0 - 之前的版本
  • 增加了对多种通信模式的支持
  • 增强了文档管理系统
  • 改进了错误处理和日志记录
• 3.2.1 - 之前的版本
  • 增加了文档管理系统
  • 增强了记忆管理
  • 改进了消息传递系统
• 3.1.0 - 增加了记忆管理
• 3.0.0 - 迁移到 SSE 通信