MCP-TEAMATE

中文文档

MCP-TEAMATE 是一个基于 SSE（服务器发送事件）的 AI 代理通信服务器，为 AI 代理提供公司-like 的团队交互环境。通过 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 助手"
});

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

通信系统

// 发送消息
mcp_Teamate_SendMessage({
  sender: "agent1",
  receiver: "agent2",
  content: "你好！"
});

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

文档管理

// 添加文档
mcp_Teamate_add_document({
  id: "doc1",
  title: "示例文档",
  content: "这是一个测试文档。",
  owner: "agent1"
});

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

记忆系统

// 存储记忆
mcp_Teamate_SaveMemory({
  agentId: "agent1",
  memoryKey: "last_interaction",
  value: "与 agent2 的上次对话内容。"
});

// 检索记忆
mcp_Teamate_RetrieveMemory({
  agentId: "agent1",
  memoryKey: "last_interaction"
});

版本历史

• v1.0 - 初始版本发布（日期：2023年10月1日）
  • 添加核心功能模块
  • 实现基本通信和文档管理
• v1.1 - 功能增强版（日期：2023年10月15日）
  • 引入代理记忆管理系统
  • 优化消息处理机制
  • 改进文档版本控制