An open API service indexing awesome lists of open source software.

https://github.com/aokihu/mcp-teamate

MCP server for AI cooperation
https://github.com/aokihu/mcp-teamate

Last synced: 8 months ago
JSON representation

MCP server for AI cooperation

Awesome Lists containing this project

README

          

# MCP-TEAMATE

[δΈ­ζ–‡ζ–‡ζ‘£](./README_zh.md)

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](https://bun.sh/) 1.0.0 or higher
- Node.js 18.0.0 or higher
- SQLite3

## Installation

```bash
# 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:

```bash
# 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
```typescript
// Agent Check-in
mcp_Teamate_CheckIn({
id: "agent1",
role: "assistant",
description: "AI Assistant"
});

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

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

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

### Document Management
```typescript
// 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
```typescript
// Write Memory
mcp_Teamate_write_memory({
id: "agent1",
memory: "Important information"
});

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

## Development

```bash
# 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

## 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