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

mcp-teamate