MCP-TEAMATE

MCP-TEAMATE

---

中文文档

MCP-TEAMATE 是一个基于 httpstream（取代了之前的 SSE）的 AI Agent 通信服务，可为 AI Agent 提供类似公司的团队协作环境。通过 MCP 协议，AI Agent 可以交流、分享知识并协同工作。

---

功能

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

先决条件

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

安装

# Clone the repository
git clone https://github.com/yourusername/mcp-teamate.git

# Navigate to project directory
cd mcp-teamate

# Install dependencies, optional
bun install

# Start development server
bun run dev

配置

可通过环境变量配置服务：

# Server host address, defaults to localhost
TEAMATE_SERVER_HOST=localhost

# Server port, defaults to 3001
TEAMATE_SERVER_PORT=3001

# Set port and run
TEAMATE_SERVER_PORT=3001 bun run dev

# Set host and port and run
TEAMATE_SERVER_HOST=0.0.0.0 TEAMATE_SERVER_PORT=3001 bun run dev

核心功能

1. Agent 管理

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

2. 通信系统

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

3. 文档管理

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

4. 记忆系统

• Agent 专属记忆存储
• 跨会话持久化记忆
• 记忆共享功能
• 记忆搜索和检索

API 概览

Agent 管理

// Agent Check-in
mcp_Teamate_check_in({
  id: "agent1",
  role: "assistant",
  description: "AI Assistant"
});

// Agent Check-out
mcp_Teamate_check_out({
  id: "agent1"
});

// Get all agents
mcp_Teamate_get_all_agents({});

// Add Memory
mcp_Teamate_add_memory({
  id: "agent1",
  memory: "Important information"
});

// Read Memory
mcp_Teamate_read_memory({
  id: "agent1"
});

// Delete Memory
mcp_Teamate_delete_memory({
  id: "agent1"
});

通信

// Send Message
mcp_Teamate_send_message({
  sender: "agent1",
  receiver: "agent2",
  content: "Hello!"
});

// Wait for Message
mcp_Teamate_wait_message({
  receiver: "agent2",
  timeout: 30000
});

// Get all messages for a receiver
mcp_Teamate_get_all_messages({
  receiver: "agent2"
});

// Get a message by ID
mcp_Teamate_get_message({
  id: "message_id"
});

// Delete a message by ID
mcp_Teamate_delete_message({
  id: "message_id"
});

文档管理

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

// Delete Document
mcp_Teamate_delete_document({
  slug: "doc1",
  secretKey: "your_secret_key"
});

// Get All Documents
mcp_Teamate_get_all_documents({});

// Get Document
mcp_Teamate_get_document({
  slug: "doc1"
});

// Update Document
mcp_Teamate_update_document({
  slug: "doc1",
  content: "Updated content",
  secretKey: "your_secret_key",
  version: "1.0.1"
});

开发

# Run development server
bun run dev

# Build project
bun run build

# Compile project
bun run compile

贡献

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

许可证

MIT

作者

aokihu [email protected]

版本历史

• 4.1.0 - 当前版本
  • 使用 httpstream 取代 SSE，实现实时通信
• 3.3.1 - 先前版本
  • 修复文档管理系统参数顺序错误
  • 提高文档内容存储的可靠性
• 3.3.0 - 先前版本
  • 新增对多种通信模式的支持
  • 增强文档管理系统
  • 改进错误处理和日志记录
• 3.2.1 - 先前版本
  • 新增文档管理系统
  • 增强记忆管理
  • 改进消息投递系统
• 3.1.0 - 新增记忆管理
• 3.0.0 - 迁移至 SSE 通信