MCP Teams

🚀 Team Messenger

Team Messenger is a messaging application built on the Model Context Protocol (MCP), supporting integration with Microsoft Teams. It offers messaging, real-time streaming, and hybrid search capabilities, and achieves advanced retrieval through PostgreSQL and the pgvector extension.

🚀 Quick Start

Team Messenger is a messaging application built on the Model Context Protocol (MCP), enabling seamless integration with Microsoft Teams. It offers a suite of features including message sending and receiving, real - time streaming, and hybrid search, leveraging PostgreSQL and the pgvector extension for enhanced retrieval.

✨ Features

• Microsoft Teams Integration: Interact with Teams messages via the Microsoft Graph API.
• Real - time Streaming: Subscribe to the messages/incoming event for real - time updates.
• Hybrid Search: Combine BM25 and vector search, supporting LLM re - ranking.
• DuckDB & PostgreSQL Support: Use DuckDB for local storage and PostgreSQL for extended retrieval.
• Command - Line Interface (CLI): Provide full MCP protocol interaction capabilities.

🔧 Technical Details

+-------------------+       +---------------------+
| Microsoft Teams  |       | MCP CLI Client      |
+-------------------+       +---------------------+
          △                 |
          |                 △
+-----------------------+  △
|   Teams Graph API    |
+-----------------------+
          |
          ↓
+-----------------------+
| MCP Server            |
+-----------------------+
          |
          ↓
+-----------------------+
| IR Server (PostgreSQL)|
+-----------------------+

📦 Installation

Environment Requirements

• Python 3.8 or higher
• Docker and Docker Compose
• PostgreSQL 14 or higher

Quick Installation

# Clone the repository
git clone https://github.com/your-org/teams-messenger.git
cd teams-messenger

# Install dependencies
pip install -r requirements.txt

# Configure environment variables
export MS_GRAPH_API_KEY="your-key"
export MCP_SERVER_PORT=5000
export IR_SERVER_URL=http://localhost:8090

Environment Variables

💻 Usage Examples

Starting the MCP Service

# Start the MCP service separately
python mcp_server.py

# Start all services via Docker-compose
docker-compose up -d

Accessing the Console

• MCP management interface: http://localhost:5000
• Retrieval server: http://localhost:8090

CLI Usage

Login and Token Management

python cli/login.py login    # User login
python cli/login.py status   # Check login status
python cli/login.py logout   # User logout

Message Operations

python cli/mcp_client.py list_chats        # List all chats
python cli/mcp_client.py get_messages <id>  # Get messages from a specified chat
python cli/mcp_client.py send_message <id> "message content"  # Send a new message

Creating a New Chat

python cli/mcp_client.py create_chat <user ID or email>

Search Function

python cli/mcp_client.py search_messages "search keyword" --mode hybrid --top_k 5

Retrieval Server Usage

Health Check

curl http://localhost:8090/

Listing Tools

curl GET http://localhost:8090/api/tools

Content Retrieval

curl POST http://localhost:8090/api/tools/search \
  -H "Content-Type: application/json" \
  -d '{"query":"search content","search_type":"hybrid","top_k":5}'

📚 Documentation

Frequently Asked Questions

• Can't connect to the Teams service?
  • Check if the API key is correct.
  • Ensure network connectivity.
• Retrieval function is abnormal?
  • Confirm that the PostgreSQL service is running properly.
  • Check the retrieval server logs.

Project Documentation

• Official documentation: Teams Messenger Documentation
• Development guide: Developer Documentation

Contact Information

• Email: support@your-org.com
• Phone: +1 (555) 123 - 4567