MCP Teams

🚀 團隊消息essenger

團隊消息essenger（Teams Messenger）是一款基於模型上下文協議（MCP）構建的消息應用程序，它支持與微軟Teams集成，具備消息收發、即時流式傳輸和混合搜索等功能，還通過PostgreSQL和pgvector擴展實現了先進的檢索能力。

🚀 快速開始

團隊消息essenger是一款強大的消息應用，能與微軟Teams無縫集成，為用戶提供便捷的消息交互體驗。以下是快速開始使用該應用的步驟：

安裝

環境要求

• Python 3.8及以上版本
• Docker及Docker Compose
• PostgreSQL 14及以上版本

快速安裝

# 克隆倉庫
git clone https://github.com/your-org/teams-messenger.git
cd teams-messenger

# 安裝依賴
pip install -r requirements.txt

# 配置環境變量
export MS_GRAPH_API_KEY="your-key"
export MCP_SERVER_PORT=5000
export IR_SERVER_URL=http://localhost:8090

運行

啟動MCP服務

# 單獨啟動MCP服務
python mcp_server.py

# 通過Docker-compose啟動所有服務
docker-compose up -d

訪問控制檯

• MCP管理界面：http://localhost:5000
• 檢索服務器：http://localhost:8090

✨ 主要特性

• 微軟Teams集成：通過Microsoft Graph API實現Teams消息交互。
• 即時流式傳輸：訂閱messages/incoming事件獲取即時更新。
• 混合搜索：結合BM25和向量搜索，支持LLM重排。
• DuckDB & PostgreSQL支持：使用DuckDB進行本地存儲，PostgreSQL進行擴展檢索。
• 命令行界面（CLI）：提供完整的MCP協議交互能力。

🔧 技術細節

架構

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

此架構展示了團隊消息essenger與微軟Teams的交互流程。用戶可以通過MCP CLI Client或Microsoft Teams與系統進行交互，系統通過Teams Graph API與微軟Teams進行通信，MCP Server負責處理核心業務邏輯，IR Server (PostgreSQL) 則提供檢索服務。

環境變量

💻 使用示例

CLI使用

登錄與令牌管理

python cli/login.py login    # 用戶登錄
python cli/login.py status   # 查看登錄狀態
python cli/login.py logout   # 用戶註銷

消息操作

python cli/mcp_client.py list_chats        # 列出所有會話
python cli/mcp_client.py get_messages <id>  # 獲取指定會話的消息
python cli/mcp_client.py send_message <id> "消息內容"  # 發送新消息

創建新會話

python cli/mcp_client.py create_chat <用戶ID或郵箱>

搜索功能

python cli/mcp_client.py search_messages "搜索關鍵詞" --mode hybrid --top_k 5

檢索服務器用法

健康檢查

curl http://localhost:8090/

列出工具

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

內容檢索

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

📚 詳細文檔

• 官方文檔：Teams Messenger Documentation
• 開發指南：開發者文檔

❓ 常見問題

1. 無法連接Teams服務？

   • 檢查API密鑰是否正確
   • 確保網絡連通性

2. 檢索功能異常？

   • 確認PostgreSQL服務正常運行
   • 查看檢索服務器日誌

📞 聯繫方式

• 郵件：support@your-org.com
• 電話：+1 (555) 123-4567