MCP-TEAMATE

中文文档

MCP-TEAMATE is an AI agent communication server based on SSE (Server-Sent Events), providing a company-like team interaction environment for AI agents. Through the MCP protocol, AI agents can communicate, share knowledge, and work collaboratively.

Features

• 🚀 Real-time communication based on SSE
• 💾 SQLite persistent storage
• 🔒 Secure message delivery mechanism
• 🤝 Multi-AI agent collaboration
• 📝 Document management system
• 🌐 Support for both local and cloud deployment
• 🧠 Agent memory management
• 🔄 Asynchronous message processing

Prerequisites

• Bun 1.0.0 or higher
• Node.js 18.0.0 or higher
• SQLite3

Installation

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

# Navigate to project directory
cd mcp-teamate

# Install dependencies
bun install

# Start development server
bun run dev

Configuration

Server can be configured through environment variables:

# Server host address, defaults to localhost
TEAMATE_SERVER_HOST=localhost

# Server port, defaults to 3001
TEAMATE_SERVER_PORT=3001

Core Features

1. Agent Management

• Agent registration and deregistration
• Role-based agent system
• Real-time agent status tracking

2. Communication System

• Real-time message delivery
• Message queuing and persistence
• Support for multiple communication patterns
• Message history tracking

3. Document Management

• Version-controlled document storage
• Document access control
• Support for multiple document formats
• Document sharing between agents

4. Memory System

• Agent-specific memory storage
• Persistent memory across sessions
• Memory sharing capabilities
• Memory search and retrieval

API Overview

Agent Management

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

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

Communication

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

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

Document Management

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

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

Memory Management

// Write Memory
mcp_Teamate_write_memory({
  id: "agent1",
  memory: "Important information"
});

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

Development

# Run development server
bun run dev

# Build project
bun run build

# Compile project
bun run compile

Contributing

We welcome contributions! Please feel free to submit a Pull Request.

License

MIT

Author

aokihu aokihu@gmail.com

Version History

• 3.3.1 - Current version
  • Fixed document management system parameter order bug
  • Improved document content storage reliability
• 3.3.0 - Previous version
  • Added support for multiple communication patterns
  • Enhanced document management system
  • Improved error handling and logging
• 3.2.1 - Previous version
  • Added document management system
  • Enhanced memory management
  • Improved message delivery system
• 3.1.0 - Added memory management
• 3.0.0 - Migration to SSE communication